COMMANDS.TXT To see some examples of using the commands in User Button scripts, read the accompanying text files (which *are* User Button scripts!) User1.txt, etc. To see an example of network control using Rebol (free from www.rebol.com) and these same commands as used over a network, read the d70.r rebol-script text file (then *get rebol and try it yourself*). CamMotionRPU (for Sony RPU 2512 OEM Panoramic Annular View Camera Block) accepts the following commands *in addition* to those listed below for BRC-300 cams. RPURing - set display mode to 'Ring' (mode in which radius modifications will work) RPUZoom - set display mode to 'Zoom' (mode in which zoom and tilt will work) RPUMode - steps through the RPU display modes RPDM # - sets the numerical display mode (# range 0 to 7) RPUCXUp - increments the CenterX value in Ring mode RPUCXDn - decrements the CenterX value in Ring mode RPUCXRes - resets the CenterX value in Ring mode RPCX # - sets the numerical CenterX value (# range 0 to 1280) XInc # - sets the increment used by the increment commands (# range 0 to 8) e.g. XINC 5 will cause RPUCXUp to increase the Center X value by 5 units instead of 1 (default=1) RPUCYUp - increments the CenterY value in Ring mode RPUCYDn - decrements the CenterY value in Ring mode RPUCYRes - resets the CenterY value in Ring mode RPCY # - sets the numerical CenterY value (# range 0 t0 640) YInc # - sets the increment used by the increment commands (# range 0 to 8) RPUInUp - increments the Inner radius in Ring mode RPUInDn - decrements the Inner radius in Ring mode RPUInRes - resets the Inner radius in Ring mode RPIR # - sets the numerical Inner radius in Ring mode (# range 0 to 640) IInc # - sets the increment used by the increment commands (# range 0 to 8) RPUOutUp - increments the Outer radius in Ring mode RPUOutDn - decrements the Outer radius in Ring mode RPUOutRes - resets the Outer radius in Ring mode RPOR # - sets the numerical Outer radius in Ring mode (# range 0 to 640) OInc # - sets the increment used by the increment commands (# range 0 to 8) RPUAutoOn - assures if you click a ring control that the ring mode will display automatically RPUAutoOff - requires you manually enter ring mode to use the ring controls RPUAutoTog - switches RPUAuto setting on/off RPU camera note: Some commands below don't do anyting (iris, focus, backlight, etc.) on the RPU camera because they simply aren't meaningful to the RPU camera. The CamMotionRPU program simply ignores those commands that apply to other cams (see below) but which aren't part of the RPU camera's command set. CamMotionPro300 accepts the following list of commands (all commands apply to GUIKIT and REBOL uses): CamHome CameraOn CameraOff PanL1 PanL5 PanL10 PanR1 PanR5 PanR10 TiltU1 TiltU5 TiltU10 TiltD1 TiltD5 TiltD10 TiltUL1 TiltUL5 TiltUL10 TiltUR1 TiltUR5 TiltUR10 TiltDL1 TiltDL5 TiltDL10 TiltDR1 TiltDR5 TiltDR10 Zoomin Zoomin5 Zoomin10 Zoomout Zoomout5 Zoomout10 ZoomMax ZoomMin Focnear Focnear5 Focnear10 Focfar Focfar5 Focfar10 FocusAuto FocusMan SetPre1 SetPre2 SetPre3 SetPre4 SetPre5 SetPre6 SetPre7 SetPre8 SetPre9 SetPre10 GoPre1 GoPre2 GoPre3 GoPre4 GoPre5 GoPre6 GoPre7 GoPre8 GoPre9 GoPre10 VerboseOn turn on verbose mode VerboseOff turn off verbose mode VerboseTog toggle verbose mode on/off 10 New user-definable 'command scripts' (same as activated by the U1-U0 buttons): User1 through User9 are the commands User1 through User9 can be used from a network remote command setup, but *not* from without the scripts themselves! In other words, you can't have a User1.txt file that contains a User1 command! The Ux GUI buttons activate (if they are available) script text files (using the command set) found in User1.txt up to User10.txt. Samples are in your CamMotion folder. For the D300, additional commands are: Up Down Left Right Stop AEOn - autoexposure set to full auto AETog - toggle between full auto and manual autoexposure IrisUp IrisDn RedUp RedDn BlueUp BlueDn ShutterUp ShutterDn ApertureUp ApertureDn BrightUp BrightDown GainUp GainDn BackLOn BackLOff WBAuto WBIn WBOut WBTog Wait # DataOn DataOff ZLOn (only for D70) ZLOff (only for D70) PSpd # TSpd # ZSpd # MSpd # PInc # TInc # TDel # GetPan GetTilt GetZoom GetAll ShowAll Comment DoPan # DoTilt # DoZoom # Move xxx,yyy starttour stoptour toggletour ********************************************** Explanations of these extra commands are: Left, Right, Up, and Down will move the cam continuously until you send the Stop/Halt command - the motion is slow and smooth. moveu moved movel mover Stop Halt zoom+ zoom- For example, in a script you could write: pspd 2 (set pan speed to slow) mover (pan to right at the very slow speed) wait 10 (wait 10 seconds) halt (stop the continuous panning) to move up for 10 seconds then stop. Remember, don't include the parenthetical explanations above in your scripts! AE is the command to turn AutoExposure mode ON AETog - turn full auto exposure on/off AEOn - turn full auto exposure on These commands change brightness and related optical settings - their meanings are obvious. BrightUp BrightDown IrisUp IrisDn RedUp RedDn BlueUp BlueDn GainUp GainDn ApertureUp ApertureDn ShutterUp ShutterDn For BRC_300 and EVI-D70 you can also set the numerical value of these optical controls numerically: siri # - range 0 to 17 sshu # - range 0 to 21 sgai # - range 0 to 7 (max is 15 on D70) sblu # - range 0 to 255 sred # - range 0 to 255 sbri # - range 0 to 23 (max is 31 on D70) sape # - range 0 to 15 for example, to set the red gain to 100: sred 100 also note these commands, like the 'up/down' ones above, will cause the cam to enter a manual white balance or manual exposure mode so the commands will be meaningful. you can return to auto white balance or auto exposure mode with the appropriate commands (wbauto, autoexpon). The following are 'zero lux' controls for cameras with IR filter cutout switches (only works on D70 cam): ZLOn ZLOff The following are back-lighting controls: BackLOn BackLOff White Balance Controls (Auto, Indoor, Outdoor): WBAuto - white balance set to full auto WBIn - white balance set to indoor WBOut - white balance set to outdoor WBTog - steps through the above 3 values in sequence Wait x Use this as 'Wait 5', for example, to wait 5 seconds between two Script commands (see the User1.txt, User2.txt, etc. files for an the new 10 buttons for user scripts). The following are data on-screen display controls: DataOn DataOff The following are speed settings for the Up, Down, Left, Right smooth movements: PSpd 5 (example for 'set pan speed to 5') min speed = 1, max = 26 (24 for the D70) TSpd 2 (example for 'set tilt speed to 2') min speed = 1, max = 26 (23 for the D70) ZSpd 3 (example for 'set zoom speed to 3') min speed = 0, max = 7 The following speed setting controls motions when you click in the 'dark blue rectangle' to move the cam to a mouse position: MSpd 7 (example for 'set move speed to 7') min speed = 1, max = 26 (23 for the D70) These commands control the 'increment of motion' for the small discrete motions (>5, <5, >1, <1): PInc 5 (example to set pan increment to 5) - multiplies units of pan by this value TInc 5 (example to set tilt increment to 5) - multiplies units of tilt by this value Maximum increment value is 8, minimum value is 1. These command start, stop, or 'toggle' the AutoTour function: stoptour starttour toggletour tdel # The TDel # command sets the AutoTour Delay time (how long the cam remains at each position): TDel 3 (example says to set a 'duration' of 3 seconds at each preset during the AutoTour) The following are network commands to read back the position of the cam: GetPan (then you must perform a 'read line from network' to get the data that come back) GetTilt (then you must perform a 'read line from network' to get the data that come back) GetZoom (then you must perform a 'read line from network' to get the data that come back) GetAll (returns a line with all the position and toggle settings) The following are network commands to tell the cam to go to a position: DoPan 23.5 (pan to 23.5 degrees) - max for D70 and BRC-300 is 170 degrees, minimum is -170 DoTilt 18 (tilt to 18 degrees) - min is -30, max 90 (reversed if cam is hanging) for the D70 and BRC-300 DoZoom 6.2 (zoom to 6.2 power) - min is 1, max is 216 ShowAll - forces the local DOS window of XCAM to display the 'GetAll' data line, use this in User-button scripts instead of GetAll Comment - forces a comment line to be replied on the network connection (of course you must read a line from the network to read it back) - e.g. Comment this is a comment (when you read the line back from the network, you will get 'this is a comment'). This can be used in User button scripts, too. Move xxx,yyy - performs a motion as if the GUI is set to 'Relative Motion' (A/R button) relative to the center of the motion panel of the XCAM GUI. xxx ranges from 000 to 319, and yyy ranges from 000 to 199. the center of the panel is 160,100 so Move 20,10 will move up and to the left while Move 200,150 will move down and to the right. This is most useful when you have set up a graphic image and you want to click on it to produce a motion that will center the cam on that point. Takes zoom into account! *******************************************************