Overview

Kohoan applications are working set "Realtime 3D Rendering System". There are three main programs.
Kohoan is NOT a 3D modeler or GUI animation tool like Blender.

(A) khrend

    features
  • Daemon process
  • Listen TCP/IP socket port 19325 ( as default )
  • Command line ascii protocol using socket.( see khrend command )
  • Shared Memory for Realtime Animation ( khanim or kheditor )
  • Draw 3D scene using OpenGL 1.1 and GLX 1.2
  • read/write Model file (scene data)

(B) khanim

Animation Contorl for (A) khrend.

    features
  • Control realtime animation and frame count
  • Event check for every frame
  • Drop the frame delayed realtime rendering.
  • Command Line interface extended TCL interpreter command.
  • Read Acl file ( Animatin Contorl Language ). Acl file systax is based on Tcl Syntax.
  • Use input device, mouse or joystick ..

(C) kheditor

GUI Contorl for (A) khrend.

    features
  • GUI Contorol viewing Model file( Scene data ), cannot object file.
  • Build GUI easily ( aschii text scripting )
  • this tools consist two part, one is Tcl/Tk extended interperter called kheditor , second is Tcl/Tk Sciprt called bosen.
    khtk
    Binary file, add original khtk command extended Tcl basic command.
    bosen
    Tcl/Tk Script file, create GUI using Tcl/Tk and khtk command..

Architecture


You prepare the following data files

(1) Model file includes 3D scene
original ascii format, have the extension .mdl

(2) Object file incidated vertex data
Original ascii format ( Almost the same as Wavefront Obj ) , have the extension .obj

(3) Image file for texture ( optinal )
accept image format depend on imlib2 library.

(4) Animation description file ( optinal )
original ascii format, have the extension .acl
syntax depend on Tcl/Tk langunage. 
                                        ------------------
                                        | (C) kheditor   | 
  --------------------------------------------------------
  |       (A) khrend      | (B) khanim  |       Tk       |
  -------------------------------------------------------
  | Imlib2  |    OpenGL   |              Tcl             |
  -------------------------------------------------------
  |                     X Window                         |
  -------------------------------------------------------
  |                  Operating System                    |
  -------------------------------------------------------

Build Kohoan

Compile Environment

  • gcc compiler
  • X11 window system
  • above OpenGL 1.1 and GLX 1.2

Operating System

  • Raspberry Pi OS (64bit)
  • Debian (bookworm)

Downloads

Packages

Require some packages before building Kohoan. 
$sudo apt-get install libjpeg-dev libpng-dev libgif-dev
$sudo apt-get install gcc g++ libfreetype-dev libx11-dev libxext-dev libgl-dev libglu1-mesa-dev libxmu-dev
$sudo apt-get install make automake pkg-config

Build Step

  1. build imlib2 library 
    $cd imlib2-1.7.4
$./configure --prefix=(install-dir)
$make install
  2. build tcl library 
    $cd tcl8.4.20/unix
$./configure --prefix=(install-dir) --enable-gcc
$make install
  3. build tk library 
    $cd tk8.4.20/unix
$./configure --prefix=(install-dir) --enable-gcc --with-x --with-tcl=../../tcl8.4.20/unix
$make install
  4. build kohoan 
    $cd kohoan-0.8.3
$./configure --prefix=(install-dir) --with-imlib2=(install-dir) --with-tcltk=(install-dir)
$make
$make install
    Add configure options , when you want to using video texutre ( require Video 4 linux 2 API )
    $./configure --prefix=(install-dir) --with-imlib2=(install-dir) --with-tcltk=(install-dir) --enable-videotexture

( optional ) Setup auto start khrend for Raspberry Pi

$cd kohoan-0.8.3
%%edit kohoan.service file , re-write (install-dir) and startup (user name)
$sudo cp kohoan.service /etc/systemd/system
$sudo systemctl enable kohoan.service

Quick Start Kohoan

Start and Stop

Clock animation demo

Controlled by mouse or joystick demo ( USB game controller )

Virtual studio demo ( USB Web camera )

khrend command

khrend Command Table
  • Red: Reserved Command and argument name
  • Green: User defined name
  • Blue: User input data
  • Pink: Command option
commandarg1arg2arg3Example
exit exit
open window/(window name) ( -b | -p | -w ) *see below posx posy width height open window/test 0 0 640 480
close window/(window name) close window/test
read model (model file name) read model test.mdl
object (object file name) read object square.obj
texture (texture file name) read texture picture.jpg
write model (model file name) write model dummy.mdl
add class/(class name) ( scl | rot | trans ) x y z add class/eye trans 10 20 0
object/(object name) ( scl | rot | trans ) x y z add object/circle rot 90 0 0
link window/(window name) scene/(scene name) link window/test scene/scene0
class/(class name) object/(object name) link class/root object/eye
select scene/(scene name) camera/(camera name) select scene/scene0 camera/camera0
scene/(scene name) switch/(switch name) select scene/scene0 switch/switch0
scene/(scene name) background/(background name) select scene/scene0 background/background0
scene/(scene name) lmodel/(lmodel name) select scene/scene0 lmodel/lmodel0
scene/(scene name) class/(class name) select scene/scene0 class/class0
swap texture/(texture name) number( max 3 digits ) swap texture/number 23
set cwd directory set cwd /usr/local/home/data
camera/(camera name) ( dv | dh | pan | tilt | twist | aspect | near | far ) data set camera/camera0 pan 45
pos x y z set camera/camera0 pos 0 100 80
material/(material name) ( ambient | diffuse | specular | emission ) r g b set material/material0 ambient 1 0 0
( shiness | opacity ) data set material/material0 opacity 1
lmodel/(lmodel name) ambient r g b set lmodel/lmodel0 ambient 1 0 0
localviewer ( on | off ) set lmodel/lmodel0 localviewer off
light/(light name) type ( spot | para | point ) set light/light0 type spot
( pos | dir ) x y z set light/light0 pos 1 20 -10
( ambient | color ) r g b set light/light0 ambient 1 0 0
spotlight spotx spoty set light/light0 spotlight 10 10
face ( on | off ) set light/light0 face on
class/(class name) ( scl | rot | trans ) x y z set class/root trans 10 10 10
drwmode ( off | face | line ) set class/root drwmode off
object/(object name) ( scl | rot | trans ) x y z set object/object0 trans 10 10 10
( map | smooth | backface ) ( on | off ) set object/object0 backface off
index number set object/object0 index 10
drawmode ( off | line | face ) set object/object0 drawmode line
texture/(texture name) wrap ( repeat | clamp ) set texture/sky wrap repeat
mapenv ( modulate | decal ) set texture/sky mapenv modulate
index number set texture/sky index 3
switch/(switch name) ( antialias | cullback ) ( on | off ) set switch/switch0 cullback on
fog density r g b set switch/switch0 fog 0.1 0.1 0.1 0.1
background/(background name) color r g b set background/background0 color 0.2 0.8 0.4
new camera (camera name) new camera camera0
material (material name) new material material0
lmodel (lmodel name) new lmodel ldemo0
light (light name) new light light0
class (class name) new class class0
object (object name) new object object0
texture (texture name) new texture texture0
switch (switch name) new switch switch0
background (background name) new background background0
scene (scene name) new scene scene0
delete camera (camera name) delete camera camera0
material (material name) delete material material0
lmodel (lmodel name) delete lmodel ldemo0
light (light name) delete light light0
class (class name) delete class class0
object (object name) delete object object0
texture (texture name) delete texture texture0
switch (switch name) delete switch switch0
background (background name) delete background background0
scene (scene name) delete scene scene0
memget size memget 1024
memreg camera/(camera name) pos ( x | y | z ) memreg camera/camera0 pos x
lmodel/(lmodel name) ambient ( red | green | blue ) memreg lmodel/lmodel0 ambient red
light/(light name) ( pos | dir ) ( x | y | z ) memreg light/light0 pos z
( ambient | color ) ( red | green | blue ) memreg light/light0 ambient green
spot ( power | angle ) memreg light/light0 spot angle
material/(material name) ( ambient | diffuse | specular | emission ) ( red | green | blue ) memreg material/material0 ambient blue
( shiness | opacity ) memreg material/material0 shiness
class/(class name) ( scl | rot | trans ) ( x | y | z ) memreg class/sample scl y
drawmode memreg class/sample drawmode
object/(object name) ( scl | rot | trans ) ( x | y | z ) memreg object/object0 scl y
( index | drawmode ) memreg object/object0 index
texture/(texture name) index memreg texture/texture0 index
background/(background name) color ( red | green | blue ) memreg background color red
memunreg (offset number) memunreg 10
get picked get picked


open window command option means
  • no option : No window frame and no mouse picked event
  • -p : No window frame and get mouse picked event
  • -b : Attach window frame and no mouse picked event
  • -w : Attach window frame and get mouse picked event
when get mouse picked event, use get command.
get command return picked class name in GL window. show picked count and all parent class name, if picked class have parent one.

Appendix

History

Kohoan was founded by Kobori Enshu

  • 1990? First developed, SGI Indigo IRIS-GL and IRIX 5.x
  • 2000? SGI Octane OpenGL and IRIX 6.x
  • 2004? Test ps2linux Mesa library.
  • 2024 Kohoan backup CD discovered in very old cardboard box!
  • 2025 Porting IRIX to Raspberry Pi

Links

News

  • 2025.03.11 This site opened.

Contacts

info at geoglyph dot info

Copyright © 2025 geoglyph.info