Skip to content

Latest commit

 

History

History
181 lines (164 loc) · 4.56 KB

readme.org

File metadata and controls

181 lines (164 loc) · 4.56 KB

s7-kinc

Here you’ll find Kinc bindings for s7 Scheme, as well as an s7 Scheme interpreter embedded into a Kinc application meant for interactive development.

Status

Work in Progress, not usable by others.

Progress of Documentation

  • [ ] Documentation
    • [ ] Getting Started
    • [ ] Project Layout
    • [ ] Naming
    • [ ] Building
    • [ ] Interactive Development
      • [ ] Developer shell environment vars
        • [ ] S7KINC_DEV_SHELL
        • [ ] S7KINC_DEV_ROOT
    • [ ] main.scm and special defines, hooks, reqlet, helper procs (i.e. with/make-g4-*-buffer), etc.
    • [ ] Examples

Progress of Application

  • [-] s7-kinc
    • [X] embed s7 interpreter
    • [X] allow access to the interpreter via a socket server
    • [X] redirect s7’s stderr out to socket clients
    • [ ] organize logging
    • [X] get .so reloads to work. Done, but existing objects are still tied to previously loaded c-functions. New c-objects use newly loaded so.
    • [-] Builds
      • [-] release build with stripped dependencies / source
      • [ ] assert / s7 error stripping?
      • [X] development build with shell / load-paths overridden

Some Notes

  • Prebuilt shared libs for kinc bindings seem to work, but themselves are not linked to some needed functions (sds, s7ctypes). Seems not to be a problem as they’re found when loaded into the main application.
  • While bindings for kinc_init and kinc_start work, the main loop is kept on the C side to avoid scheme-side errors halting the loop (which occurs when it’s started on the scheme side). This way the REPL remains useful.
  • opaque types
    • kinc_compute_constant_location
    • kinc_compute_shader
    • kinc_compute_texture_unit
    • kinc_event
    • kinc_fiber
    • kinc_mutex
    • kinc_semaphore
    • kinc_thread
    • kinc_thread_local
    • kinc_uber_mutex
    • kinc_g4_constant_location
    • kinc_g4_index_buffer
    • kinc_g4_shader
    • kinc_g4_texture_array
    • kinc_g4_texture_unit
    • kinc_g4_vertex_buffer
    • kinc_g5_command_list
    • kinc_g5_compute_shader
    • kinc_g5_constant_location
    • kinc_g5_index_buffer
    • kinc_g5_shader
    • kinc_g5_texture_unit
    • kinc_g5_vertex_buffer
    • kinc_video

Progress of Bindings

  • [-] Kinc
    • [X] color
    • [X] display
    • [ ] error
    • [-] image
    • [ ] log
    • [X] system
    • [ ] video
    • [X] window
    • [ ] audio1
      • [ ] audio
      • [ ] sound
      • [ ] soundstream
    • [ ] audio2
    • [ ] compute
    • [X] graphics1
    • [ ] graphics2
    • [-] graphics4
      • [X] constantlocation
      • [-] graphics
      • [X] indexbuffer
      • [-] pipeline
      • [ ] rendertarget
      • [X] shader
      • [ ] texture
      • [ ] texturearray
      • [X] textureunit
      • [X] usage
      • [-] vertexbuffer
      • [X] vertexstructure
    • [ ] graphics5
      • [ ] commandlist
      • [ ] compute
      • [ ] constantbuffer
      • [ ] constantlocation
      • [ ] graphics
      • [ ] indexbuffer
      • [ ] pipeline
      • [ ] raytrace
      • [ ] rendertarget
      • [ ] shader
      • [ ] texture
      • [ ] textureunit
      • [ ] vertexbuffer
      • [ ] vertexstructure
    • [ ] input
      • [ ] acceleration
      • [ ] gamepad
      • [ ] keyboard
      • [ ] mouse
      • [ ] pen
      • [ ] rotation
      • [ ] surface
    • [ ] io
      • [ ] filereader
      • [ ] filewriter
    • [ ] math
      • [ ] core
      • [ ] matrix
      • [ ] quaternion
      • [ ] random
      • [ ] vector
    • [ ] network
      • [ ] http
      • [ ] socket
    • [ ] simd
    • [ ] threads
      • [ ] atomic
      • [ ] event
      • [ ] fiber
      • [ ] mutex
      • [ ] semaphore
      • [ ] thread
      • [ ] threadlocal
    • [ ] vr

Linux Backend Not Implemented

The following functions are ‘!’ (not yet implemented / empty definition), or ‘~’ (may possibly be improved), in Kinc’s Linux backend:

display.h

  • ~ kinc_display_available
  • ~ kinc_display_name
  • ~ kinc_display_count_available_modes
  • ~ kinc_display_available_mode

window.h

  • ! kinc_window_create
  • ! kinc_window_destroy
  • ! kinc_count_windows
  • ! kinc_window_resize
  • ! kinc_window_move
  • ! kinc_window_change_features
  • ! kinc_window_change_framebuffer
  • ! kinc_window_x
  • ! kinc_window_y
  • ! kinc_window_display
  • ! kinc_window_show
  • ! kinc_window_hide
  • ! kinc_window_set_ppi_changed_callback
  • ! kinc_window_vsynced

system.h

  • ! kinc_login
  • ! kinc_unlock_achievement
  • ! kinc_disallow_user_change
  • ! kinc_allow_user_change
  • ! kinc_set_keep_screen_on

graphics4/graphics.h (opengl backend)

  • ~ kinc_g4_render_occlusion_query -> in backend / not in api (OpenGL only?)
  • ~ kinc_g4_start_occlusion_query -> in api / not in backend (Direct3D only?)
  • ~ kinc_g4_end_occlusion_query - in api / not in backend (Direct3D only?)