BlackTrax BTSensor Manual

page of 298

/ 298
Contents
Table of Contents
Bookmarks

Table of Contents

Quick Links

BlackTrax Wiki

A Complete BlackTrax User Wiki

BlackTrax Wiki

1 of 298

5/14/2019

Table of Contents

Chapters

Table of Contents

Need help?

Do you have a question about the BTSensor and is the answer not in the manual?

Questions and answers

Summary of Contents for BlackTrax BTSensor

Page 1 BlackTrax Wiki A Complete BlackTrax User Wiki BlackTrax Wiki 1 of 298 5/14/2019...
Page 2 CAST and copyright protected. For more information, go to http://cast-soft.com/third-party-libraries/.  A BlackTrax License will authorize the use of the BlackTrax system for a restricted number of output connections based on the type of License that was purchased. For more information, go to Licensing.
Page 3 About this Manual Table of contents: Introduction Text Conventions BlackTrax Wiki 3 of 298 5/14/2019...
Page 4 WYSIWYG Reference Guide.” Instructions to direct you to diﬀerent features of the BTSystem or areas in the physical Space are indicated by being Green and Underlined. For Example “In the Physical Space, take the BTBeacon.” BlackTrax Wiki 4 of 298 5/14/2019...
Page 5 BlackTrax System Overview BTSensor Installation Environment Considerations for BTSensor Installation Installing a BTSensor Lens BTSensor Placement and Orientation BTSystem Hardware Conﬁguration BTSystem Conﬁguration Optional Equipment Conﬁguration BTSystem Components Standard System Components BTServer TimeKeeper BTRouter Ferrite Filter eSync 2 Controller BTSensors 3.7.1...
Page 6 6.1.1 Compatible DMX/Ethernet nodes 6.1.2 Luminex Node Settings 6.1.3 Common ArtGate Node Setup Guide System Procedures Licensing Charging BTBeacons Replacing a BTBeacon's Lithium-Ion Battery Installing Third Party Software Server Failover BlackTrax Wiki 6 of 298 5/14/2019...
Page 7 BTSensor Installation Table of contents: Environment Considerations for BTSensor Installation Installing a BTSensor Lens BTSensor Placement and Orientation BlackTrax Wiki 7 of 298 5/14/2019...
Page 8 Cabling: Ethernet connected BTSensors are subject to the limitation of Ethernet communication standards. The total Ethernet connection between any component to the BTServer can not be longer than 91.44m for BlackTrax to function correctly. This range may be extended with a PoE switch to link cables together.
Page 9 To install a BTSensor lens Note: Only used on s250e and Slim 13E sensors. Screw the lens onto the BTSensor with the included plastic lens tensioner between the M12 lens adapter and the lens itself. Tighten until proper focus is achieved.
Page 10 BTSensor Placement and Orientation In order for tracking to function correctly, multiple BTSensors must be arranged to have overlapping ﬁelds of view of the Space. A BTSensor's ﬁeld of view is the part of the Space that is visible through the BTSensor while the BTSensor is in a ﬁxed position and orientation.
Page 11 BTSystem Hardware Conﬁguration Table of contents: BTSystem Conﬁguration Optional Equipment Conﬁguration BlackTrax Wiki 11 of 298 5/14/2019...
Page 12 TimeKeeper, BTRouter and eSync 2 Controller can be positioned closer to the tracking space. The following diagram outlines a typical hardware conﬁguration and demonstrates how all BlackTrax hardware modules are connected together. Attention: The Timekeeper and BTRouter Ethernet port are designed only to connect to a commercially available Power over Ethernet (PoE) network switch.
Page 13 Optional Equipment Overview Depending on your tracking needs, additional components must be connected with the BTSystem. The following outlines how to connect this optional equipment with the BTSystem. Tracking with Moving Light Fixtures Diagram BlackTrax Wiki 13 of 298 5/14/2019...
Page 14: Table Of Contents
Wand Head Triangular Wand Holder Telescopic Wand Handle Ground Plane Hybrid Power Supply Unit (HPSU) Lighting Wand BTCalibration Kit Case Stringer Discontinued eSync Controller S250e Slim Power Supply Unit (PSU) BTServer (Legacy) TimeKeeper (Legacy) BlackTrax Wiki 14 of 298 5/14/2019...
Page 15 BTSystem are dependent on each user’s needs and on the individual sale. (1) BTServer (pre-installed software below) Hardware secured inside the server BTX Dongle Motive Dongle Pre-installed software BTWYSIWYG Motive for BlackTrax BlackTrax Software Suite Device Manager (1) BTRouter (1) TimeKeeper Ferrite ﬁlters (1) eSync 2 Controller*...
Page 16: Btserver
(2x) Intel I350 Quad-Port Gigabit Ethernet Controller (1 dedicated, 1 deﬁnable) Windows 10 IoT Enterprise LTSB 2016 Default User Login User name: btuser Note: There is no password associated with the default user account for the BTServer Default Network Address (Main) BlackTrax Wiki 16 of 298 5/14/2019...
Page 17 BTLink is the network connection link to the other BTServers. Attention: Windows Remote Desktop Connection should not be used with a BlackTrax system. Security measures on the BTX dongle installed in the BTServer will prevent it from working. Users should use TeamViewer or VNC if remote access to a BTServer is required.
Page 18: Timekeeper
Power: 48VDC/15.6W from PoeE Network Switch via Ethernet port (No input power via USB port) Status LEDs Note: The Ethernet status lights on the TimeKeeper are not enabled while the TimeKeeper is in use. BlackTrax Wiki 18 of 298 5/14/2019...
Page 19 Ghz frequencey to send data to all BTBeacons. Data sent includes a signal used to synchronize the BTBeacons with the BTSensors and conﬁguration commands sent to the eSync Controller via a BNC cable. TimeKeeper Transmitter Characteristics BlackTrax Wiki 19 of 298 5/14/2019...
Page 20: Btrouter
Weight: 125 g (4.41 oz) Operating Temperature 0°C to +40°C (32°F to 104°F) Input/Output & Power Data: Ethernet, Radio 2.4(GHz) 10Hz Power: 48VDC/15.6W from PoE Network Switch via Ethernet port (No input power via USB port) Status LEDs BlackTrax Wiki 20 of 298 5/14/2019...
Page 21 Note: Upon delivery of a new BTSystem shipment, the IMU on most of the Beacons included are disabled by default, and the IMU of the Beacon with ID 1 will be switched on by default to help with Fixture Calibration. BTRouter Transmitter Characteristics BlackTrax Wiki 21 of 298 5/14/2019...
Page 22: Ferrite Filter
The ferrite ﬁlter is a cylindrical clamp fastened over cables to conform with regulatory standards. A ferrite ﬁlter must be clamped over any cables connected to the TimeKeeper and BTRouter. Ferrite ﬁlters should be fastened on any connected cables as close to the respective device as possible. BlackTrax Wiki 22 of 298 5/14/2019...
Page 23: Esync 2 Controller
2 Controller Connection to the TimeKeeper The eSync 2 Controller connects to the TimeKeeper over RCA cable. A BNC/RCA adapter is used to plug the RCA into input 3 of the eSync 2 Controller. BlackTrax Wiki 23 of 298 5/14/2019...
Page 24: Btsensors
BTSensors Table of contents: SLIM 13E PRIME 41 BlackTrax Wiki 24 of 298 5/14/2019...
Page 25: Slim 13E
Horizontal FOV: 82° Vertical FOV: 70° Adjustable focus with wave spring assist 850nm band-pass ﬁlter 850nm (Infrared) / 700nm (Visible) Filter Switcher Image Sensor Resolution: 1280 × 1024 Frame Rate: 30–240 FPS (100 FPS average usage) BlackTrax Wiki 25 of 298 5/14/2019...
Page 26 Firmware updates are automatic when starting the connection to the BTServer. If you revert back to an older version of the ﬁrmware as well. This process is automatic. BTSensor Functions BTSensors are used to view BTBeacon positions in the Space. A BTBeacon's position in 3 dimensions (X, Y, and Z) can be determined when two or more BTSensors simultaneously have a direct line-of-sight to a connected Stringer’s LED.
Page 27 Standard PoE switches must provide a full 15.4 watts to every port simultaneously. Note that PoE Midspan devices or power injectors are not suitable for Ethernet camera systems. BlackTrax Wiki 27 of 298 5/14/2019...
Page 28: Prime 41
Image Sensor Resolution: 2048 x 2048 Pixel Size: 5.5 µm x 5.5µm Frame Rate: 30–180 FPS (adjustable) Latency: 5.5ms Shutter type: global Shutter speed: Default: 0.5 ms (500 µs) Minimum: 0.01 ms (10 µs) Maximum: BlackTrax Wiki 28 of 298 5/14/2019...
Page 29 The switch must provide consistent power to every port simultaneously in order to power each sensor. Standard PoE switches must provide a full 15.4 watts to every port simultaneously. Note that PoE Midspan devices or power injectors are not suitable for Ethernet camera systems. BlackTrax Wiki 29 of 298 5/14/2019...
Page 30: Btbeacon
Watt hour: 4.44 Wh normal operation, 5.04 Wh while charging Operating Temperature 0°C to +40°C (32°F to 104°F) BTBeacon Status LEDs (During Operation) Warning: If a BTBeacon experiences a charge error, there could be a potential issue with the Lithium-ion BlackTrax Wiki 30 of 298 5/14/2019...
Page 31 BTBeacon into the BTSmart Charger. This mode is used to update ﬁrmware. BTBeacon Transmitter Characteristics BTBeacon Charging Information A BTBeacon’s rechargeable lithium-ion battery is not fully charged when shipped. Please read the following instructions carefully: BlackTrax Wiki 31 of 298 5/14/2019...
Page 32 After a period of time the battery of the BTBeacon will naturally decay through normal use and require replacement. Contract your BTE for details on replacing the BTBeacon battery. Attention: Any unauthorized modiﬁcation to the BTBeacon or its battery will invalidate any warranty claim and may damage the device. BlackTrax Wiki 32 of 298 5/14/2019...
Page 33: Bt Smart Charger
6 BTBeacons at one time. BTSmart Charger Conﬁgurations The BTSmart Charger can be conﬁgured to either be horizontal and sit ﬂat on a desk, or be vertical and be mounted on a wall. BlackTrax Wiki 33 of 298 5/14/2019...
Page 34 Horizontal Conﬁguration Diagram BlackTrax Wiki 34 of 298 5/14/2019...
Page 35: Calibration Kit
Calibration Kit Table of contents: Calibration Kit functions Wand Head Triangular Wand Holder Telescopic Wand Handle Ground Plane Hybrid Power Supply Unit (HPSU) Lighting Wand BTCalibration Kit Case BlackTrax Wiki 35 of 298 5/14/2019...
Page 36: Calibration Kit Functions
The Ground Plane is connected to the Power Supply Unit and placed in the designated origin of the Space. The Ground Plane LEDs are used in the BlackTrax system to calculate the BTSensor positions relative to the origin and the orientation of the Cartesian axes.
Page 37: Wand Head
Wand Head Wand Head Size and Weight Width: 105.92 cm (41.7”) Height: 26.92 cm (10.6”) Depth: 2.03 cm (0.8”) Weight: 715 g (25.22 oz) BlackTrax Wiki 37 of 298 5/14/2019...
Page 38: Triangular Wand Holder
Triangular Wand Holder Triangular Wand Holder Size and Weight Length: 24 cm (9.45”) Height: 17.5 cm (6.89”) Width: 4.45 cm (1.75”) Weight: 420g (14.82 oz) BlackTrax Wiki 38 of 298 5/14/2019...
Page 39: Telescopic Wand Handle
Telescopic Wand Handle Telescopic Wand Handle Size and Weight Length: 2.03 cm (0.8”) Height: 149.86 cm (59”) Width: 2.03 cm (0.8”) Weight: 365 g (12.86 oz) BlackTrax Wiki 39 of 298 5/14/2019...
Page 40: Ground Plane
Ground Plane Ground Plane Size and Weight Width: 76.96 cm (30.3”) Length: 98.04 cm (38.6”) Depth: 5.08 cm (2”) Weight: 1905 g (67.2 oz) BlackTrax Wiki 40 of 298 5/14/2019...
Page 41: Hybrid Power Supply Unit (Hpsu)
Beacons with either 2 or 3 Stringers attached have approximately 1 hour of additional usage time. Changing Internal Batteries in the HPSU Attention: Please use an anti-static mat while being grounded. Tool Required: *1/16 hex bit key. To add batteries to the second pack BlackTrax Wiki 41 of 298 5/14/2019...
Page 42 Remove the 4 screws from Side A using the 1/16 hex bit. Once the screws are removed, pull the panel away to reveal the interior of the HPSU. Note: HPSU board slides into the bottom slot of the interior. BlackTrax Wiki 42 of 298 5/14/2019...
Page 43 Carefully pull the board out from the HPSU. You only need to remove the board half way to replace the batteries. Once you have replaced the batteries, tighten the Velco straps on the batteries. Slowly and carefully push the board back into the HPSU. BlackTrax Wiki 43 of 298 5/14/2019...
Page 44: Lighting Wand
Lighting Wand Lighting Wand Size and Weight Size: 2 m (6.56’) Weight: 235 g (8.29 oz) BlackTrax Wiki 44 of 298 5/14/2019...
Page 45: Btcalibration Kit Case
BTCalibration Kit Case BTCalibration Kit Case Outside dimensions: 134.6 x 40.6 x 15.5 cm (53” x 16” x 6.12”) Weight: (with foam lining only): 11.6 kg (25.57 lbs.) BlackTrax Wiki 45 of 298 5/14/2019...
Page 46 When a Stringer is connected to a BTBeacon LED port, the LED portion of a Stringer will pulse that BTBeacon’s unique ID signal. The pulse is viewed by BTSensors, sent to the BTServer and used to calculate the BTBeacon position in the Space. BlackTrax Wiki 46 of 298 5/14/2019...
Page 47 Discontinued Table of contents: eSync Controller S250e Slim Power Supply Unit (PSU) BTServer (Legacy) TimeKeeper (Legacy) BlackTrax Wiki 47 of 298 5/14/2019...
Page 48: Esync Controller
LED Stringers attached to BTBeacons. eSync Controller Connection to the TimeKeeper The eSync Controller connects to the TimeKeeper over RCA cable. The RCA cable is plugged into the RCA port of the eSync Controller. BlackTrax Wiki 48 of 298 5/14/2019...
Page 49: S250E Slim
Vertical FOV: 34° M12 Lens Mount Adjustable focus with wave spring assist 800nm IR long pass ﬁlter with Filter Switcher Image Sensor Resolution: 832 × 832 Frame Rate: 30–250 FPS (100 FPS average usage) Accuracy: Sub-millimeter BlackTrax Wiki 49 of 298 5/14/2019...
Page 50 Shutter Type: global Shutter Speed: Default: 0.5 ms (500 µs) Minimum: 0.01 ms (10 µs) Maximum: 3.8 ms (3,800 µs) at 100 FPS Input/Output & Power Data: Ethernet Synchronization: Ethernet Power: (PoE) 15.4 watts BlackTrax Wiki 50 of 298 5/14/2019...
Page 51: Power Supply Unit (Psu)
Power Supply Unit (PSU) Power Supply Unit (PSU) Size and Weight Width: 10.5 cm (4.1”) Height: 9.8 cm (3.8”) Depth: 4.57 cm (1.8”) Weight: 335 g (11.82 oz) Power Power: 10 Watt BlackTrax Wiki 51 of 298 5/14/2019...
Page 52: Btserver (Legacy)
(2x) 2.5" 500GB HDD SATA in RAID 1 16GB (4x4GB) 1866MHz DDR3 ECC RDIMM NVidia GeForce GTX 760 -or- Earlier Dual, Hot-plug, Redundant Power Supply (1+1), 1100W Intel X520-T2 Dual Port 10GbE Network Interface Card DVD-ROM Optical Disk Drive BlackTrax Wiki 52 of 298 5/14/2019...
Page 53 4GB RDIMM, 1600MT/s, Low Volt, Single Rank, x8 Data Width NVidia GeForce GTX 760 -or- Earlier Dual, Hot-plug, Redundant Power Supply (1+1), 1100W Broadcom 5720 Quad Port 1Gb Network Interface Card DVD-ROM Optical Disk Drive Windows 7 Professional BlackTrax Wiki 53 of 298 5/14/2019...
Page 54: Timekeeper (Legacy)
Power: 48VDC/15.6W from PoeE Network Switch via Ethernet port (No input power via USB port) Status LEDs Note: The Ethernet status lights on the TimeKeeper are not enabled while the TimeKeeper is in use. BlackTrax Wiki 54 of 298 5/14/2019...
Page 55 Ghz frequencey to send data to all BTBeacons. Data sent includes a signal used to synchronize the BTBeacons with the BTSensors and conﬁguration commands sent to the eSync Controller via an RCA cable. TimeKeeper Transmitter Characteristics BlackTrax Wiki 55 of 298 5/14/2019...
Page 56 General System Information Table of contents: BTSystem Information Flow and Connections BTX Dongle Saved System Data FCC Information BlackTrax Wiki 56 of 298 5/14/2019...
Page 57 BTSystem Information Flow and Connections Introduction The following diagram outlines how the components of the BTSystem are connected and how data ﬂows between the diﬀerent modules of the system. BlackTrax Detailed System Diagram BlackTrax Wiki 57 of 298 5/14/2019...
Page 58 Embedded inside each BTServer is a BTX dongle which serves two principal uses. The primary function of a dongle is to act as a key. The dongle is the only way that BlackTrax software will open and operate. The dongle has dynamic embedded information that controls the level of the software you can open/use, as well as the expiry date of the Membership Period.
Page 59 Saved System Data In BlackTrax, when system information is saved, the information is saved to a general folder on the BTServer. Information saved this way includes conﬁguration ﬁles and system lists from sub-processes. By default this folder can be found at the following location, depending on your server version and BlackTrax release version: All BlackTrax Servers running v2.0.0 or later - C:\bt_run_time...
Page 60 This equipment generates, uses and can radiate radio frequency energy and, if not installed and used in accordance with the instructions, may cause harmful interference to radio communications. Certiﬁcate Numbers Model BTTKV01: Radio Cert. No.: IC: 10858A-BTTKV01 Model BTBCV01P: Radio Cert. No.: IC: 10858A-BTBCV01 BlackTrax Wiki 60 of 298 5/14/2019...
Page 61 Not Included Mandatory Components Attention: BlackTrax requires additional components to function which are not included with purchase of the BTSystem. Category 6 Ethernet Cabling Power Over Ethernet Gigabit Switch for BTSensors BlackTrax Wiki 61 of 298 5/14/2019...
Page 62 All Ethernet cabling used to connect the system components together must be of Category 6 (Cat6) quality or greater. Cat6 is necessary for the transmission of data at gigabit speeds, which is required by BlackTrax. The amount of cable needed will vary depending on the Space dimensions and user needs.
Page 63 (VLAN) to connect all the BTSensors with the rest of the system. The switch should have the following: A PoE gigabit switch. A PoE port for each BTSensor, plus 4 extra to connect to the TimeKeeper, BTRouter, eSync Controller and BTServer. PoE switches must support 15.4 watts per Ethernet port.
Page 64 Depending on the purpose of tracking, you may need additional hardware components that are not included with the BTSystem. DMX/Ethernet Node for Tracking with Moving Lights Compatible DMX/Ethernet nodes Luminex Node Settings Common ArtGate Node Setup Guide BlackTrax Wiki 64 of 298 5/14/2019...
Page 65 When the merging channel is at full (100%) intensity, BlackTrax has complete control over the channels connected to the BlackTrax project. When the merging channel is at zero (0) intensity, the lighting console has full control over the channels in the BlackTrax project.
Page 66 Compatible DMX/Ethernet nodes To connect BlackTrax downstream to a lighting console, a DMX to Ethernet/Ethernet to DMX node is required. The following nodes have been tested and are approved to work with BlackTrax: Luminex Luminex Ethernet-DMX2/Truss MkII Luminex Ethernet-DMX4 MkII...
Page 67 The Luminex Ethernet DMX nodes must be conﬁgured to work with your BlackTrax system. Attention: The following guide outlines how each variable should be set for use with BlackTrax. Each BlackTrax event is unique. There are circumstances where these settings need to be modiﬁed based on factors such as the rig, cabling, and patching.
Page 68 Note: It is recommended that the reroute is done to a universe which is diﬀerent than the universes from the console and BlackTrax. For example, if you are merging sACN universe 1, with RTTrPL universe 1, you might re route the merged data to sACN universe 101.
Page 69 Common ArtGate Node Setup Guide DMX nodes of the ArtGate family of models must be conﬁgured to work with your BlackTrax system. Attention: The following guide outlines how each variable should be set for use with BlackTrax. Each BlackTrax event is unique. There are circumstances where these settings need to be modiﬁed based on factors such as the rig, cabling and patching.
Page 70 System Procedures Table of contents: Licensing Charging BTBeacons Replacing a BTBeacon's Lithium-Ion Battery Installing Third Party Software Server Failover BlackTrax Wiki 70 of 298 5/14/2019...
Page 71 Unrecognized devices on the BlackTrax Network are not compatible with the software. An unrecognized device is any device on the BlackTrax Network that was not sold directly to you by CAST Software. A BlackTrax License will authorize the use of the BlackTrax system for a restricted number of output connections based on the type of License that was purchased.
Page 72 Connect the BTBeacon to the charge station via the Mini USB port found on the side of the BTBeacon. Result: The BTBeacon is charging. To determine when the BTBeacon is fully charged, see BTBeacon status LEDs (During operation). BlackTrax Wiki 72 of 298 5/14/2019...
Page 73 Fasten screws to the back of the BTBeacon case, sealing it. Press the Power button down. Result: The lights of the BTBeacon will ﬂash and the unit will turn on. The BTBeacon’s battery has successfully been replaced. Opening the case to remove the battery BlackTrax Wiki 73 of 298 5/14/2019...
Page 74 Disconnecting the ribbon cable Adding new double sided tape, and insert new battery Reconnecting the ribbon cable Closing the case BlackTrax Wiki 74 of 298 5/14/2019...
Page 75 Note: If third party software must absolutely be installed on the BTSystem, please contact CAST or your local BTE for a possible solution. If a BTE or CAST deems the software acceptable, they may arrange to install it for you. BlackTrax Wiki 75 of 298 5/14/2019...
Page 76 Therefore, the backup server should not have these modules open, or be disconnected from all networks until needed. The BlackTrax GUI, and BTWYG can be opened, with their ﬁles loaded on both servers at the same time. In the event of needing to switch servers, ensure the main BTServer has been disconnected from it's associated networks.
Page 77 Patching and Assigning an ID to Fixtures in BTWYSIWYG 1.12 Patching DMX Universes to a Console 1.13 Patching Universes to BlackTrax 1.14 Applying BTX information to BlackTrax from BTWYSIWYG Optional .BTX Information BlackTrax Zones Planning BTSensor Placement Introduction BTSensor Placement...
Page 78: Preparing The Btwyg File
Hanging Moving Fixtures in BTWYSIWYG Best Practices for Moving Fixture Placement Patching and Assigning an ID to Fixtures in BTWYSIWYG Patching DMX Universes to a Console Patching Universes to BlackTrax Applying BTX information to BlackTrax from BTWYSIWYG BlackTrax Wiki 78 of 298 5/14/2019...
Page 79 Space. BTWYSIWYG exports this information as a .btx ﬁle, which is then used by BlackTrax as a blueprint for tracking in the Space. If you are tracking with moving ﬁxtures, ﬁxture position and patching must also be included in the .btx ﬁle.
Page 80: Creating A Btwysiwyg Project
BTWYSIWYG project associated with the launched BlackTrax project is automatically created and opens by default. When a new BTWYSIWYG project is created from BlackTrax, all necessary settings and conﬁgurations are automatically applied to that new BTWYSIWYG project. These template projects simplify the setup process for BTWYSIWYG on new installations.
Page 81: Saving The Btwysiwyg Project
Save As. Result: The Save as window appears. In the window, navigate to where you want to save the project ﬁle. In the File name ﬁeld type in the name of the project. Click Save. BlackTrax Wiki 81 of 298 5/14/2019...
Page 82: Requirements For Creating The Space In Btwysiwyg
To use BlackTrax you are required to create a virtual representation of the Space in BTWYSIWYG. This virtual Space will possess vital information that BlackTrax requires as follows: what the dimensions and tracking area of the Space are, what objects or people you want BlackTrax to follow (Trackables), and information on devices in use (e.g., ﬁxtures).
Page 83: Deﬁning A Common Origin In Btwysiwyg
Space. The origin in the Physical Space needs to be visible to at least 2 BTSensors for BTSensor calibration to function. The location of the origin needs to be consistent. The origin needs to be the same in the BTWYSIWYG virtual Space, in Motive, in the...
Page 84 Document Origin, which is set by default to be the center point of the BTWYSIWYG venue deﬁned for the event. Document Origin Icon User Origin: The user origin icon appears when you have set a new User Origin for the ﬁle. User Origin Icon BlackTrax Wiki 84 of 298 5/14/2019...
Page 85: Creating The Venue In Btwysiwyg
ﬂoor, but you won't be able to spin them using Fixture Properties. Note: Due to the complexity of recreating an accurate representation of a venue, refer to the WYSIWYG Reference Guide’s chapter on The CAD environment for a thorough understanding. BlackTrax Wiki 85 of 298 5/14/2019...
Page 86: Creating Trackables In Btwysiwyg
Important Notes: Trackables are automatically named and patched when created. By default, when a New Portfolio is launched from BlackTrax, BTWYSIWYG opens with 12 Trackables. To create a trackable in BTWYSIWYG In BTWYSIWYG CAD mode, from the...
Page 87 BTTrackable. Trackable object with a person attached Note: The BlackTrax Template ﬁle has one Trackable and avatar created and patched by default. It is possible to create multiple Trackables at once using the array tool in BTWYSIWYG, and this created Trackable.
Page 88: Patching Trackables In Btwysiwyg
Patching Trackables in BTWYSIWYG Patching Trackables Introduction Important Note: As of BlackTrax v2.2, the Quick Motion Patch Tool is no longer required to patch Trackables because Trackables are automatically named and patched when inserted. Trackables that are created need to be patched to a Motion Universe. The patch allows the visualization of Trackable movement in BlackTrax.
Page 89 Only Selected Trackable/Axes is selected. Click Clear. Result: All selected Trackables are unpatched from the motion universe. The total number of patched Trackables cleared will be reported at the bottom of the window. Click Close. BlackTrax Wiki 89 of 298 5/14/2019...
Page 90: Hanging Moving Fixtures In Btwysiwyg
If you want moving ﬁxtures to follow a Trackable, you must place and hang the moving ﬁxtures in BTWYSIWYG. When a moving ﬁxture is placed in BTWYSIWYG, BlackTrax collects valuable ﬁxture information such as the properties, range of capabilities, orientation and position in the venue.
Page 91: Best Practices For Moving Fixture Placement
Trackable which moves in a circular path underneath, this can cause ﬁxtures to spiral and reach a pan stop. Note: BlackTrax has a feature where if a ﬁxture pan-ﬂips, the ﬁxture will dim while performing the ﬂip. This is in place to reduce the disruption caused by the pan-ﬂip during operation.
Page 92: Patching And Assigning An Id To Fixtures In Btwysiwyg
1:1 by default. When tracking occurs, BlackTrax uses the DMX values generated by the console, but overrides the pan and tilt channels with new values. These new values direct the ﬁxture to aim and follow a Trackable. If a ﬁxture was edited to have a constant beam size, the zoom and iris values will also change.
Page 93 ﬁxtures are ﬁrst sorted so ﬁxtures are organized. Fixtures can be sorted in order of position, or Unit # along a pipe/truss. This can also be used for patching ﬁxtures as well. DATA>Spreadsheet with ﬁxtures patched for BlackTrax BlackTrax Wiki 93 of 298...
Page 94: Patching Dmx Universes To A Console
BlackTrax requires that the patching information of the connected console be recorded in BTWYSIWYG. This will inform BlackTrax which console is in use and which ports will transmit information. When a new BTWYSIWYG project is created from BlackTrax, DMX universes are automatically created and patched 1:1 by default.
Page 95: Patching Universes To Blacktrax
BTWYSIWYG. After universes are created, be it motion or DMX, this information will need to be patched to BlackTrax. This will inform BlackTrax which of its ports are in use and which ports will transmit information. To patch universes to BlackTrax...
Page 96: Applying Btx Information To Blacktrax From Btwysiwyg
To send BTX information with BTX Apply in BTWYSIWYG LIVE mode In BTWYSIWYG LIVE mode, open the BlackTrax window. Ensure that the BlackTrax Portfolio is open, and BTWYSIWYG is connected to it. In the BlackTrax window of BTWYSIWYG , click Apply.
Page 97: Optional .Btx Information
Optional .BTX Information Table of contents: BlackTrax Zones BlackTrax Wiki 97 of 298 5/14/2019...
Page 98: Blacktrax Zones
Space. Zones are available in rectangular, cylindrical and spherical shapes of any size. BlackTrax has a number of preset interaction between Zones and ﬁxtures, which can be accessed in the Chapter section in BlackTrax. For more information see To enable a Zone for a Fixture.
Page 99 Result: The Zone will be inserted into the Space. It can be repositioned by dragging and dropping where needed. The dimensions of the Zone can be altered by manipulating the Zone directly, or by right-clicking the Zone and selecting Properties. BTWYG drawing with a Spherical Zone selected BlackTrax Wiki 99 of 298 5/14/2019...
Page 100: Planning Btsensor Placement
Planning BTSensor Placement Table of contents: Introduction BTSensor Placement BlackTrax Wiki 100 of 298 5/14/2019...
Page 101: Introduction
BlackTrax project. Planning BTSensor placement in BTWYSIWYG helps you test the BTSensor’s coverage of the venue and determine how best to position them. BTSensors must not be placed any closer than 1m apart to help ensure optimal sensor calibration.
Page 102: Btsensor Placement
When BTSensors are hung, the BTSensor’s ﬁeld of view will correctly project in the visualization. A BTSensor ﬁeld of view of in BTWYSIWYG is depicted as a red beam Everything in the red beam is what the BTSensor can see.
Page 103 BTSensors should go and how they should be aimed to maximize the tracking area in the venue. Any gaps in coverage where tracking cannot occur will also be shown. Once the position and orientation of BTSensor have been determined, you can record the data to reproduce the BTSensor placement in the actual venue.
Page 104: Blacktrax Visualization
BlackTrax Visualization Table of contents: Introduction Using BTWYSIWYG as a Tracking Visualizer Using Calibration Data to Adjust Visualization in BTWYSIWYG Using Stick Beams for Fixtures in BTWYSIWYG Shaded View Camera Control BlackTrax Wiki 104 of 298 5/14/2019...
Page 105 BTWYSIWYG depending on the settings deﬁned in the BlackTrax System Conﬁguration widget. BTWYSIWYG, Motive, and BlackTrax must be open and running the project ﬁle for visualization to work correctly. To visualize BlackTrax activity in BTWYSIWYG In BlackTrax, open the BlackTrax project ﬁle.
Page 106: Using Btwysiwyg As A Tracking Visualizer
BlackTrax. This mode hides all objects attached to Trackables in BTWYSIWYG. Trackable Focused: Displays only LEDs and Centroids that are actively patched to a Trackable in BlackTrax. This mode also displays objects attached to the Trackable in BTWYSIWYG. Select Trackable Objects Only: Select this checkbox to choose only Trackable objects in the Shaded view of BTWYSIWYG.
Page 107 An LED appears as a circle outline when behind an object in Shaded view. An LED appears in the color that is identical to the Beacon color in BlackTrax. When an LED is selected, its color turns to white and the text label identiﬁcation appears. For example, the screenshot (above) shows "L:101.4"...
Page 108 Result: The Trackables and Beacons panel appears and displays the list of Trackables, Beacons, and Frames associated with the connected BlackTrax project. In the Trackables and Beacons panel, click on the arrow at the far left of the list of Trackables, Beacons or Frame to expand or collapse the corresponding list below them.
Page 109: Using Calibration Data To Adjust Visualization In Btwysiwyg
Using Calibration Data to Adjust Visualization in BTWYSIWYG Once ﬁxtures have their position calibrated in BlackTrax, this information can be used to improve visualization in BTWYSIWYG. The position of ﬁxtures in BTWYSIWYG will change to the calibration locations, creating a more accurate visualization.
Page 110: Using Stick Beams For Fixtures In Btwysiwyg
This reduces clutter and confusion in the visualization and helps determine where ﬁxtures are aiming and which ﬁxtures are selected. To use ﬁxture stick beams in BTWYSIWYG In BlackTrax, open the BlackTrax project ﬁle. In BTWYSIWYG LIVE mode, go to the BlackTrax panel.
Page 111: Shaded View Camera Control
*Aﬀected by View Option, "Pan tool moves objects". Keyboard Actions Note: In the Application Options window, you can choose Traditional WYSIWYG on the Shaded View Camera Control list if you want to use the standard WYSIWYG camera control in Shaded view. BlackTrax Wiki 111 of 298 5/14/2019...
Page 112 Motive for BlackTrax Table of contents: Initial Setup Introduction Layout Presets in Motive BTSensor Diﬀerences in Motive BTSensor Presets Checking the Connectivity of BTSensors Using Motive to Aim BTSensors BTSensor Aim Assist Feature Motive Project File BTSensor Calibration BTSensor Calibration Settings...
Page 113: Initial Setup
Initial Setup Table of contents: Introduction Layout Presets in Motive BTSensor Diﬀerences in Motive BTSensor Presets Checking the Connectivity of BTSensors Using Motive to Aim BTSensors BTSensor Aim Assist Feature Motive Project File BlackTrax Wiki 113 of 298 5/14/2019...
Page 114 Motive Introduction The Motive module is used to manage and control BTSensors. Motive is part of the BlackTrax software suite that is already installed on the BTServer and is ready for you to use. The following section will guide you through speciﬁc steps on how to use Motive to conﬁgure BTSensors to work in the Space function with the BTSystem.
Page 115: Layout Presets In Motive
Layout Presets in Motive Custom preset layouts in Motive were created for BlackTrax and set as preset layouts which can be restored quickly from the Layout menu or from the Main Toolbar drop-down menu. The custom preset layouts for BlackTrax are:...
Page 116: Btsensor Diﬀerences In Motive
Depending on your tracking needs, the type of BTSensors used in your BTSystem will vary. Each model of BTSensor has slightly diﬀerent settings in Motive. Due to these diﬀerent settings, steps outlined in this manual may be slightly diﬀerent depending on what BTSensor is in use.
Page 117: Btsensor Presets
View menu, choose Devices Pane. In the Devices window, select a single BTSensor, or select all BTSensors in the group by clicking the group name. At the top of the Devices window, click the Preset drop-down menu and select the desired preset.
Page 118: Checking The Connectivity Of Btsensors
BTSensors are disconnected. Tip: To help identify BTSensors, you can click the Aim Assist button on a BTSensor in the Devices window, and the corresponding BTSensor will ﬂash yellow in the Camera Preview window. BlackTrax Wiki 118 of 298...
Page 119: Using Motive To Aim Btsensors
Tracking occurs in an area when 2 or more BTSensors view the same area at the same time. A video feed of what BTSensors see is shown in Motive. By viewing the BTSensor’s video feed in the visible spectrum, BTSensor positioning can be evaluated.
Page 120 Filter Switch ﬁeld to Visible Spectrum. Set the Video Type ﬁeld to one of the MJPEG mode options. Result: The video displayed from the BTSensors will appear as a grayscale image in the visible spectrum. BlackTrax Wiki 120 of 298 5/14/2019...
Page 121: Btsensor Aim Assist Feature
Aim Assist button on the BTSensor. Result: In Motive, the BTSensor will be selected and its live video feed prominently displayed. The BTSensor’s video feed will be toggled between its current settings and Aim Assist mode. Aim Assist location BlackTrax Wiki...
Page 122: Motive Project File
In Motive, recorded motion capture data is stored as a Take (.tak) ﬁle format, all application-related conﬁgurations are saved onto Proﬁle XML (.xml) ﬁles, and calibration data for each BTSensor position, orientation and lens parameters are saved as standalone calibration CAL (.cal) ﬁle format.
Page 123 Motive project. Notes: When a new Motive project is created from BlackTrax, all necessary settings and conﬁgurations are automatically applied to that new project. These template projects can be used to simplify the setup process for Motive on new installations.
Page 124: Btsensor Calibration
BTSensor Calibration Table of contents: BTSensor Calibration Settings Masking Infrared Interference for Calibration Calibrating a BTSensor BlackTrax Wiki 124 of 298 5/14/2019...
Page 125: Btsensor Calibration Settings
Before BTSensor calibration can occur, certain settings in Motive must be conﬁgured. Motive 2 In Motive, calibration data for each BTSensor position, orientation and lens parameters are saved as standalone calibration CAL (.cal) ﬁle format which can be exported to a desired location for later use.
Page 126 > Calibration). Go to the Cameras window. Note: To quickly conﬁgure a BTSensor for calibration, change the preset setting of the BTSensor to Tracking, then proceed to Step 6 in this section. In the Cameras window, select the sensor group by clicking on the group name.
Page 127: Masking Infrared Interference For Calibration
Masking Infrared Interference for Calibration Masking is a function in Motive where an area of the BTSensor’s vision is masked (blocked from view). This tells the system to ignore the masked section when looking for infrared sources. This is used primarily to mask outside infrared interference that can confuse the system during BTSensor calibration.
Page 128 Result: The mask is removed if toggle subtractive is selected. The mask is added if toggle additive is selected. Motive 1.10 or lower To automatically mask all visible infrared sources from all BTSensors Attention: Automatic masking will remove all previous masks from the BTSensor. In Motive, go to the Camera Preview window.
Page 129 In Motive, go to the Camera Preview window. Result: What each connected BTSensor sees is displayed as a 2D image in the Camera View window. If BTSensors are conﬁgured to see infrared sources, they appear as white objects. On the...
Page 130: Calibrating A Btsensor
Proper calibration is very important because incorrect calibrations will send incorrect position data and erroneously aﬀect the BTSystem's accuracy. Attention: Anytime a BTSensor is moved or bumped, BTSensor calibration must be performed and saved to the Motive project ﬁle. See...
Page 131 LEDs are not covered or being blocked from BTSensor view. Tip: When in use, the front facing LED on the Slim 13E BTSensor turns blue to indicate that the wand is visible. You must ﬁll as much of a BTSensor's view with as much wanding data as possible to improve calibration accuracy.
Page 132 Project. Partial BTSensor Calibrations As mentioned above, it is possible for the user to calibrate sections of their BTSensor setup after the initial calibration, as opposed to having to recalibrate the entire BTSensor setup (as of Motive 1.10). The partial BTSensor calibrations are based oﬀ either a Full or Reﬁne calibration as you would do above.
Page 133 The calibration report will let you know how accurate each BTSensor is relative to each other. If one BTSensor is poor, it might be okay if there are several other BTSensors seeing that same area.
Page 134 Save Project. Note: The axis in Motive is diﬀerent than the axis in BlackTrax. Please keep that in mind when oﬀsetting the ground plane in Motive. For reference: BlackTrax +X = Motive -X BlackTrax +Y = Motive +Z...
Page 135: Tracking Mode
Tracking Mode Table of contents: Tracking Mode Settings Customizing Tracking Bounds Optional View Settings BlackTrax Wiki 135 of 298 5/14/2019...
Page 136: Tracking Mode Settings
After BTSensors are calibrated, minor adjustments need to be entered in Motive for the system to switch from BTSensor calibration to tracking mode. These settings enable ﬁxture tracking to occur. Once tracking mode is conﬁgured, no changes to the Motive project are needed unless BTSensors were moved or bumped since BTSensor calibration.
Page 137 BTE to be resolved. Note: If you experience Tracking issues after conﬁguring these settings, reset Motive Settings from the BlackTrax GUI. If your issue is not resolved, please contact BlackTrax support for further assistance. BlackTrax Wiki...
Page 138: Customizing Tracking Bounds
Attention: In Motive, the Z axis represents length and the Y axis represents height. For the rest of BlackTrax the Z axis represents height and the Y axis represents length. +X also becomes -X in Motive. Note: Be aware of the -Y setting for your Space. If the origin of the...
Page 139 To export a calibration CAL ﬁle. To set BlackTrax BTSensor beam length Attention: The Maximum distance should be the largest distance between a BTSensor and the furthest tracking boundary. The minimum distance should be the shortest distance between a BTSensor and the closest tracking boundary.
Page 140 Attention: In Motive, the Z axis represents length and the Y axis represents height. In the rest of BlackTrax the Z axis represents height and the Y axis represents length. +X also becomes -X in Motive. Note: Be aware of the -Y setting for your Space. If the origin of the...
Page 141: Optional View Settings
Optional View Settings Because every Space is diﬀerent, there are certain BTSensor settings that will be unique. This section provides guidelines on certain Motive settings which will create an accurate tracking environment. Motive 2 To enable visualization of the tracking boundary...
Page 142 Adding a Reticle to BTSensor Views A reticle (cross-hair) can be added to all BTSensor views to aid in aiming and position. Note: When the aim-assist feature is used on a BTSensor, a reticle is automatically toggled on for that BTSensor.
Page 143: Recording In Motive
Recording in Motive Table of contents: Introduction Modes in Motive Working with Recordings Calibrating BTSensors from a Recording BlackTrax Wiki 143 of 298 5/14/2019...
Page 144 In Motive, you can save recordings of tracked objects and you can play back these recordings at another time. You can record the wanding of the Space while calibrating BTSensors. The recorded wanding can be played back anytime instead of physically repeating the wanding of the Space. BlackTrax Wiki 144 of 298 5/14/2019...
Page 145: Modes In Motive
View. Attention: When Motive is in EDIT mode, no live data is sent through the BTSystem. Be sure that no application downstream of BlackTrax is relying on tracking information while switching between LIVE and EDIT modes. Motive 1.10 or lower LIVE: Information shown in LIVE mode is happening in real-time.
Page 146 Perspective View. Attention: When Motive is in EDIT mode, no live data is sent through the BTSystem. Be sure that no application downstream of BlackTrax is relying on tracking information while switching between LIVE and EDIT modes. BlackTrax Wiki 146 of 298...
Page 147: Working With Recordings
Any trackable object in the Space will be recorded to ﬁle. When you want to stop recording, click the Red Circle again. Result: Motive will exit REC mode. The recording will be saved as a .tak ﬁle. BlackTrax Wiki 147 of 298 5/14/2019...
Page 148 (arrow icon) to play the recording in the Timeline pane. Result: The recording of what BTSensors saw will be replayed for the system. The BTSystem will act as if the recording were actually happening in real-time. BlackTrax Wiki 148 of 298 5/14/2019...
Page 149: Calibrating Btsensors From A Recording
On the Timeline, click the Live button, to return the system to Live mode. Set your ground plane as per normal. BlackTrax Wiki 149 of 298 5/14/2019...
Page 150 BlackTrax GUI Table of contents: Before Using BlackTrax BlackTrax User Interface Introduction Portfolio Manager Layout of the BlackTrax GUI 2.3.1 Full Screen Mode Menu Bar 2.4.1 File Menu 2.4.2 Edit Menu 2.4.3 View Menu 2.4.4 Settings Menu 2.4.5 Modules Menu 2.4.5.1...
Page 151 6.6.6 Beacons Section Output Conﬁguration 6.7.1 Active Outputs 6.7.2 Edit Output 6.7.3 Sending Trackables 6.7.4 Output Options 6.7.5 Output Conﬁguration Settings for Third Parties System Status Widget Keyboard shortcuts Record Tracking and Lighting Data BlackTrax Wiki 151 of 298 5/14/2019...
Page 152: Before Using Blacktrax
Before Using BlackTrax Attention: Before running the BlackTrax GUI, you must complete the following mandatory steps to ensure a successful BlackTrax experience: Set up the BTSystem in the Space: The BTSystem needs to be physically installed in the Space. BTSystem Hardware Conﬁguration for more information.
Page 153: Blacktrax User Interface
BlackTrax User Interface Table of contents: Introduction Portfolio Manager Layout of the BlackTrax GUI Full Screen Mode Menu Bar File Menu Edit Menu View Menu Settings Menu Modules Menu Module Status Help Menu Toolbars Docking Widgets Status Bar BlackTrax Wiki...
Page 154 System Conﬁguration (enabled by default). Before the Edit view and the other views of BlackTrax are explained, we will ﬁrst deﬁne the options in Portfolio Manager and describe the various parts of the user interface. The Splash Screen upon launch of BlackTrax...
Page 155: Portfolio Manager
Portfolios in Portfolio Manager. The new BlackTrax and BTWYSIWYG ﬁles are generated and saved in the new Portfolio. To duplicate a portfolio Portfolio Manager, select the Portfolio that you want to duplicate.
Page 156 To import a ﬁle(s) from a portfolio BlackTrax and BTWYSIWYG ﬁles can be imported into new Portfolios. When importing ﬁles, the user does not need to import all ﬁle types. If no ﬁle is imported for a given section, the template ﬁle will be used for that portion of the Portfolio.
Page 157 All the BlackTrax and BTWYSIWYG ﬁles in the selected Portfolio open. Messages window of BlackTrax appears showing the most recent change in the state of the system. New Portfolios open with 12 Trackables by default for BlackTrax and BTWYG. Notes: How the Portfolio Manager...
Page 158: Layout Of The Blacktrax Gui
The views of BlackTrax are: Live view: The Live view is where you monitor a BlackTrax project. From this view, you have the ability to manually switch between Chapters and Books or enable Chapter Control from a console. You can connect or disconnect BlackTrax modules to the system as well as view the current BTBeacon patch, data and their Trackables.
Page 159 Full Screen Mode BlackTrax can display the GUI in a full screen mode. You can hide the Windows interface and focus directly on your programming/tracking work. To switch between full screen or windowed mode From the View menu, choose Full Screen Mode Windowed Mode.
Page 160: Menu Bar
Settings: Modify system and project settings. Modules: Access to the various modules of the BlackTrax System, including BTEngine and BTWYG Help: About information for your current release of BlackTrax and quick access to the License Folder. BlackTrax Wiki...
Page 161: File Menu
Updating BTX Projects If a BTWYSIWYG ﬁle (.btx) has been edited since it was used to make a BlackTrax project ﬁle (.btprj), Update BTX Projects can be used to update the BlackTrax project ﬁle. Any new .btx information will be carried over to the existing .btprj while maintaining any work you have already done to the project.
Page 162 Live menu, choose BlackTrax Panel BlackTrax panel is closed). Result: The BlackTrax panel appears. Ensure BTWYG is connected to BlackTrax (if it is not, click connect). In the BlackTrax window, click BTX Apply. In BlackTrax, from File menu, choose Apply BTWYG Updates.
Page 163 If an output data with the same name is already present in your ﬁle, the changes will be highlighted, and you are given the option to overwrite the current output with these new settings. The Output Conﬁguration data stored in the .btoc is applied to the current project in BlackTrax. To export output conﬁguration data...
Page 164 Closing BlackTrax You can close BlackTrax from the ﬁle menu, at which point it will ask you to save the project, if changes were detected. To close BlackTrax From the File menu, choose Exit BlackTrax. If prompted, save or discard project changes.
Page 165 To discard your changes From the Edit menu, choose Discard Changes. Click to conﬁrm you wish to discard all changes. Result: All changes are discarded back to the last time you clicked Apply Changes. BlackTrax Wiki 165 of 298 5/14/2019...
Page 166: View Menu
Upper Middle Section This section contains commonly used widget functions. Switching to Full Screen Mode The BlackTrax GUI can be displayed in full screen mode. You can hide the Windows interface and work directly on programming and tracking. From the...
Page 167 Edit Books (In Multi Book Projects) Edit Chapters Libraries Fixture Settings Trackable Settings Undo Stack Terminal Fixture Calibration Sub-View Fixture Calibration Control Fixture Calibration Properties Fixture Calibration Points Frame Calibration Sub-View Frame LEDs Rigid Frame Construction BlackTrax Wiki 167 of 298 5/14/2019...
Page 168: Settings Menu
Menu Output Conﬁguration: Output Conﬁguration widget displays the active tracking output data from the Output Modules and Trackable Settings as a result of the tracking operation in BlackTrax. Project Properties: In Project Properties, you will ﬁnd settings and information of the current...
Page 169: Modules Menu
Modules Menu BlackTrax Modules Menu Introduction Modules menu launches these modules that are used with BlackTrax. If you are in full screen mode, selecting a module will exit full screen mode. Modules Module Status: Displays the list of currently active modules. See Module Status page.
Page 170: Module Status
(excluding BTWYG). In the Module Status widget, you may click Shutdown BTEngine to close all BTEngine modules at once. Modules Status widget BlackTrax Wiki 170 of 298 5/14/2019...
Page 171: Help Menu
ﬁnd the shortcut to the License Folder location, and the About BlackTrax dialog box with information about BlackTrax, product version, and build number. The default License Folder location is C:\bt_run_time\license. For information on how to download the...
Page 172: Toolbars
View Toolbar View and Sub-View Toolbar There are three toolbars in the BlackTrax GUI: Main, Views, and Sub-Views. Main: On top of the left side, contains basic operations such as saving , as well as common functions found throughout the software such as Reset View, Beacon Patch, and a fullscreen option.
Page 173: Docking Widgets
The close function will close the widget, at which point you must re-open it from the View menu or toolbar. Diﬀerent widgets function in diﬀerent ways, and their speciﬁc function will be covered in other sections of this documentation. BlackTrax Wiki 173 of 298 5/14/2019...
Page 174: Status Bar
When in Normal Mode, in the status bar, click the Normal Mode button to switch to Fixture Calibration Mode. Result: BlackTrax is set to Fixture Calibration Mode and the features of the Fixture Calibration view is unlocked. To disable ﬁxture calibration BlackTrax Wiki...
Page 175 When in Fixture Calibration Mode, in the status bar, click the Fixture Calibration button to switch to Normal Mode. Result: BlackTrax is set to Normal Mode and the Fixture Calibration view features is locked. BlackTrax Wiki 175 of 298 5/14/2019...
Page 176: Live View
Running Chapters Widget Running Books Widget Trackable Details Widget Live View showing all Trackables in the BlackTrax Project Live Trackables In the main window at the center area of the Live View is where you will ﬁnd live trackable information, showing the current BTBeacon patch data and their Trackables.
Page 177 Centroid Tab will display battery information, as well as the XYZ Calculated centroid of a trackable, as well as Roll, Pitch, Yaw and BTBeacon information. LED Tab will display battery information, as well as the XYZ information of individual LED Stringers connected to the beacon. BlackTrax Wiki 177 of 298 5/14/2019...
Page 178: Running Chapters Widget
When Tracking is active, assigned ﬁxtures will follow the Trackables assigned to the selected active Chapter. Selecting which Chapter to activate can be controlled by using manual control in BlackTrax, or using DMX via Art-Net or sACN from a connected lighting console.
Page 179 With DMX Input enabled, the Auto Scroll feature becomes available for use. Auto Scroll will make the chapter list always display the active chapter when enabled. In the Running Chapters widget, click Auto Scroll. BlackTrax Wiki 179 of 298 5/14/2019...
Page 180: Running Books Widget
When a Book is recalled, the list of Chapters in the Book is displayed in the Running Chapters widget. Selecting which Book to recall can be controlled by using manual control in BlackTrax, or using DMX via Art-Net or sACN from a connected lighting console. Running Books Widget Manual Book Control Manual control enables the control of Books from within the BlackTrax GUI.
Page 181: Trackable Details Widget
Soft frame is assigned. The widget lists the name of all the beacons assigned to the frame, as well as the battery status, and a visibility icon (Blue for visible, red for not visible, grey for inactive). BlackTrax Wiki 181 of 298...
Page 182: Editing View
Speciﬁc customization can also be enabled in a chapter such as conﬁguring how a BTBeacon’s LEDs should be used for Tracking; if a zone is to be used in the chapter; and if a terminal command is used to alter tracking behavior. Edit View Overview BlackTrax Wiki 182 of 298 5/14/2019...
Page 183: Chapter Conﬁguration
Sensitivity Oﬀset Auto Spot Mode Zone Click the Clear Trackable Selection button at the bottom of the top pane of the central widget to clear the selected individual trackable or all the selected trackables. BlackTrax Wiki 183 of 298 5/14/2019...
Page 184 ﬁxtures by spot number or ﬁxture type across the selected chapters. Click the Clear Selection button at the bottom to clear the selected individual ﬁxture or all the selected ﬁxtures. BlackTrax Wiki 184 of 298 5/14/2019...
Page 185: Edit Chapters Widget
For the changes to take eﬀect, click Apply Changes. To name a chapter In the Edit Chapters widget, in the Name ﬁeld of the chapter, double-click to enable editing. BlackTrax Wiki 185 of 298 5/14/2019...
Page 186 Edit Chapters Widget in Multi Book Mode Edit Chapters Widget In Extended Chapters (with Books) mode, the Edit Chapters Widget displays the name of the selected Book where the current selected Chapter is accessed. See Edit Books Widget. BlackTrax Wiki 186 of 298 5/14/2019...
Page 187: Edit Books Widget
Edit Books Widget Overview When BlackTrax is in Multi Book mode, Chapters can be created, edited, saved and managed as part of a Book or Books. In the Edit Books widget, a Book with Chapters can be created, removed, re-ordered or selected for editing.
Page 188 To write a description of a book In the Edit Books widget, double-click the Description ﬁeld of the selected Book. Write the description in the Description ﬁeld. For the changes to take eﬀect, click Apply Changes. BlackTrax Wiki 188 of 298 5/14/2019...
Page 189: Libraries Widget
A blue checkmark is displayed to indicate that the Trackable has been assigned to a chapter or chapters. Depending on your BlackTrax project, you may have a large amount of Trackables to keep track of. The Search Trackables function helps you to sort and locate the exact Trackables you need.
Page 190 Fixtures based on the ID assigned in BTWYSIWYG. By Fixture Name will search for Fixtures based on how a Fixture is named in BlackTrax. By Trackable will search for Fixtures currently assigned to a Trackable (in the selected chapter) based on the BT Trackable name.
Page 191 Names. Libraries Widget viewing the Zones Tab BlackTrax Wiki 191 of 298 5/14/2019...
Page 192: Fixture Settings Widget
Spot 1 has a zoom setting of 1m and Spot 2 has a zoom setting of 2m. When you select both ﬁxtures, the text box will highlight blue to indicate a diﬀerence between the two selected ﬁxtures. Fixture settings - Basic tab (With multiple ﬁxtures selected, diﬀerences highlighted and Intensity Control features marked.) BlackTrax Wiki 192 of 298 5/14/2019...
Page 193: Basic Tab
Beam Size Control BlackTrax allows you to control the size of a ﬁxture’s beam while it is following a Trackable. This is done using the iris or zoom features of a ﬁxture. The beam setting of a ﬁxture is linked to the chapter it was created.
Page 194 If all LEDs of the patched Beacon becomes hidden, BlackTrax automatically douses the ﬁxture to 0 (from console control) after the reaction time is complete. BlackTrax automatically fades in the ﬁxture when at least one LED is visible and after the reaction time is complete.
Page 195 (milliseconds) in the Ahead Time ﬁeld. Assign how reactive you want the ﬁxture to follow by adjusting the Turner value slider to between Smooth or Responsive. For the changes to take eﬀect, click Apply Changes. BlackTrax Wiki 195 of 298 5/14/2019...
Page 196: Oﬀset Tab
Under the Oﬀset subsection, enter how far oﬀ from the centroid you want to oﬀset tracking in the X, Y or Z axis by entering the values in the X, ﬁelds. For the changes to take eﬀect, click Apply Changes. BlackTrax Wiki 196 of 298 5/14/2019...
Page 197: Auto Spot Tab
If the Trackable moves outside of the distance measured over the course of the speciﬁed Dampening Time, a new distance range is set. Note: Auto Spot Mode is determined per ﬁxture, per Chapter. To enable auto spot mode for a ﬁxture BlackTrax Wiki 197 of 298 5/14/2019...
Page 198 Fixture Icon selected, go to the Fixture Settings widget. Under the Auto Spot Mode Settings section, select the checkbox next to the desired Auto Spot Mode(s). For the changes to take eﬀect, click Apply Changes. BlackTrax Wiki 198 of 298 5/14/2019...
Page 199 Choose how you want to interact with the zone, click on an option from the Collision Type drop- down menu. For the changes to take eﬀect, click Apply Changes. Note: See “BlackTrax Zones” for more information on creating zones for a BlackTrax project. BlackTrax Wiki 199 of 298 5/14/2019...
Page 200: Trackable Settings Widget
Dynamic Zone, and react based oﬀ the current Chapter programming. Assume Outside: When the Trackable loses motion, the ﬁxtures assigned to the Trackable will assume they are outside of the Dynamic Zone, and react based oﬀ the current Chapter programming. BlackTrax Wiki 200 of 298 5/14/2019...
Page 201: Programming Chapters
Note: Fixtures can also be assigned a Trackable by dragging ﬁxtures from the Fixtures and dropping them onto a Trackable Container. For the changes to take eﬀect, click Apply Changes. To unassign a ﬁxture from a trackable BlackTrax Wiki 201 of 298 5/14/2019...
Page 202 Overwrite dialog box appears. Click Overwrite to cut and paste the selected Fixture/s or click Keep to cancel the operation and keep the previous Fixture/s. For the changes to take eﬀect, click Apply Changes. BlackTrax Wiki 202 of 298 5/14/2019...
Page 203: Undo Stack
Result: The Edit View goes to the applied state of BlackTrax in Edit View that is associated with the selected history in the Undo Stack widget.
Page 204: Terminal Widget
ﬁxtures= - The ﬁxtures following the Trackable. Note: The ﬁxture is identiﬁed by the ﬁxture ID used in BlackTrax. Fixtures will follow in the order stated. Fixtures can be expressed as a range (e.g. ﬁxtures=1-10), or listed individually (e.g. ﬁxtures=1,7,20).
Page 205: Error Codes For Unsupported Fixtures
ﬁxture conﬁguration displaying the ﬁxture model proﬁle and the error codes. The descriptions of the error codes are listed below. If you receive an unsupported ﬁxture error code, please report it to BlackTrax support, with the model, and any error codes received.
Page 206 RGBOI RGB Oﬀset Incorrect CWOI Color Wheel Oﬀset Incorrect NCWOI Non Color Wheel Oﬀset Incorrect GWOI Gobo Wheel Oﬀset Incorrect AWOI Animation Wheel Oﬀset Incorrect PWOI Prism Wheel Oﬀset Incorrect BlackTrax Wiki 206 of 298 5/14/2019...
Page 207: Calibration View
Fixture Calibration Points Widget Fixture Calibration Single and Multi-Fixture Calibration Multi-Person Calibration Reﬁning Calibration Data Managing Calibration Data Frame Calibration View Body Frames Frame LEDs Widget Rigid Frame Construction Widget Creating Frames Rigid Frames Soft Frames BlackTrax Wiki 207 of 298 5/14/2019...
Page 208: Fixture Calibration View
A maximum of 24 presets are available for the calibration of ﬁxtures in multiple positions. To have a ﬁxture follow an assigned Trackable, BlackTrax ﬁrst determines the position of the Trackable. This is done using the BTSensors and the BTBeacon assigned to the Trackable. BlackTrax references where a ﬁxture is based on information collected from the BTWYSIWYG .btx ﬁle.
Page 209 180 degree pan/tilt movement which could cause the hang structure to shake. Setting a longer time to complete the Flip Pan will make the movement smoother and avoid any change in position or alignment. BlackTrax Wiki 209 of 298 5/14/2019...
Page 210 Clearing Colour and Gobos, and Controlling Intensity BlackTrax will also attempt to auto clear any colour and gobos that the console is instructing the ﬁxture to use. While in Fixture Calibration Mode, BlackTrax will also control the intensity of the ﬁxtures, turning them on or oﬀ...
Page 211 Tilt Status: Sets the orientation of the tilt movement. Click on this drop-down and select Normal or Inverted. When a ﬁxture is calibrated, this setting will always revert back to what the ﬁxture is set to in WYSIWYG. BlackTrax Wiki 211 of 298 5/14/2019...
Page 212 The ﬁxture will no longer respond to the updated motion until the beam is unfrozen or a point is collected. Also the same as pressing A on the Beacon. Not available in Control Mode: Manual. BlackTrax Wiki 212 of 298 5/14/2019...
Page 213 To turn oﬀ ﬁxture calibration On the status bar, click Fixture Calibration. Result: The BTSystem exits Calibration Mode and enter Normal Mode. The features of the Fixture Calibration page are disabled. BlackTrax Wiki 213 of 298 5/14/2019...
Page 214: Single And Multi-Fixture Calibration
Point. Tip: Pressing the B button on the BTBeacon being tracked activates Collect Data Point remotely. Result: BlackTrax will collect the data of the BTBeacon and ﬁxture as a measurement point when Collect Data Point is selected. It will add the data to the Fixture Calibration Points section.
Page 215 ﬁeld. Click OK. Result: The selected ﬁxtures are joined in a ﬁxture group. To collect measurement points for multiple ﬁxtures In BlackTrax, in the Fixture Calibration View, in the Fixtures section, select the Preset number from Preset: drop-down list. You may click Rename to type a new name for the selected preset.
Page 216 Tip: Pressing the button on the BTBeacon being tracked activates Collect Data Point remotely. Result: BlackTrax will collect the data of the BTBeacon and ﬁxture as a measurement point when Collect Data Point is clicked. It will add the data to the Fixture Calibration Points section.
Page 217 Multi-Person Calibration Multi-Person Fixture Calibration is a feature of BlackTrax, which allows any number of people to simultaneously calibrate a group of ﬁxtures. Fixtures table Assigning Beacons When calibrating ﬁxtures, you can assign individual beacons either by group, or on an individual basis. In the Fixture Table, you can right-click a ﬁxture's Assign Beacon column and select...
Page 218: Reﬁning Calibration Data
In the Fixture Calibration Points widget, select any measurement points you want to delete. Click Delete Point(s). Result: The selected measurement points are deleted from the ﬁxture. BlackTrax Wiki 218 of 298 5/14/2019...
Page 219: Managing Calibration Data
Fixture calibration data can be saved as a calibration ﬁle separate from the BlackTrax project. Calibration can be saved as a BlackTrax Calibration ﬁle (.btcal) which can be read by BlackTrax, or as an XML ﬁle for third-party use. Calibration proﬁles saved as .btcal ﬁles can be loaded and edited as needed in a project.
Page 220 Clear All Data. Result: A dialog box appears asking if you really want to clear all calibration data from the project. Click Yes. Result: All calibration data are removed from all ﬁxtures in the project. BlackTrax Wiki 220 of 298 5/14/2019...
Page 221: Frame Calibration View
LED becomes hidden or is removed, tracking will continue but shift to follow the centroid of the remaining LEDs. You can not oﬀset the centroid of a Soft Frame, and no orientation data is calculated. BlackTrax Wiki 221 of 298...
Page 222 (create) a Frame to the list after the Frame ID and Type have been speciﬁed. Delete button: Delete button removes a Frame from the list. Note: Click Cancel in the delete conﬁrmation dialog that appears. BlackTrax Wiki 222 of 298 5/14/2019...
Page 223 Click this button to copy and paste a selected frame, then type the new frame ID in the Clone Frame dialog that will appear. Reset All Frames: Click this button to reset the frames listed in the table. BlackTrax Wiki 223 of 298 5/14/2019...
Page 224 To replace a beacon In the Frame LEDs widget, right-click on a selected beacon in the table. Result: The Replace Beacon tooltip is displayed. Click on the Replace Beacon tooltip. Result: The Replace Beacon dialog box appears. BlackTrax Wiki 224 of 298 5/14/2019...
Page 225 From the drop-down list, select the Beacon ID which will replace the selected Beacon. Click OK. Result: The new Beacon ID number is displayed in the table with the corresponding LED ID. Note: Re-construct the Rigid Frame in the Rigid Frame Construction widget, then click Apply Changes. BlackTrax Wiki 225 of 298 5/14/2019...
Page 226 +/- 0.10m. Orientation Oﬀset applies any oﬀsets to the Orientation of the currently selected Rigid Frame after the Rigid Frame is constructed. To set the orientation oﬀset values BlackTrax Wiki 226 of 298 5/14/2019...
Page 227 Click on the cell then use the mouse wheel to scroll in increments of +/- 1 degree. Click on the cell, press and hold CTRL and use the wheel to scroll in increments of +/- 10 degrees. BlackTrax Wiki 227 of 298 5/14/2019...
Page 228 Rigid Frame Construction widget, you can also monitor the Centroid for both Rigid and Soft frames, as well as the orientation for Rigid Frames. This section describes the process of creating both Rigid and Soft frames. BlackTrax Wiki 228 of 298 5/14/2019...
Page 229 Once the ﬁrst three LEDs are placed, any further LEDs added to the rigid body can be placed anywhere and will be used as additional tracking points for the object, but are not required. BlackTrax Wiki 229 of 298 5/14/2019...
Page 230 A home position is where the object will be 0,0,0 for the Roll, Pitch, and respectively. You can manually perform this action, but it is much easier to let BlackTrax determine this for you. To use the set home function Align the real world object along the same plain as the world coordinate system (ensure your X, Y, and Z directions match where you set the ground plane.
Page 231: Soft Frames
The centroid of a soft frame cannot be set as the centroid is constantly being re- calculated based on the position of the LEDs that the frame is made up of. BlackTrax Wiki 231 of 298...
Page 232 BlackTrax Wiki 232 of 298 5/14/2019...
Page 233: Global Widgets
System Conﬁguration System Section Fixture Calibration Section Frame Calibration Section BTWYG Section Cameras Section Beacons Section Output Conﬁguration Active Outputs Edit Output Sending Trackables Output Options Output Conﬁguration Settings for Third Parties System Status Widget BlackTrax Wiki 233 of 298 5/14/2019...
Page 234: Beacon Patch
Space. The orientation of a Trackable is based on the IMU within the BTBeacon or the calculated orientation of a rigid frame. BlackTrax interprets the data based on the conﬁguration of the Trackable as it was set in the Trackable Settings widget.
Page 235 BTBeacon or the solution based on the rigid frame. Button A : This indicates the current status of the A button on the BTBeacon. The button can be set to either ON or OFF. This button is used in ﬁxture calibration. BlackTrax Wiki 235 of 298 5/14/2019...
Page 236 LED 3 : The number next to the icon is the identifying numbered pulse of the LED in the BTBeacon’s port 3. LED 3 Data : This is the current Cartesian coordinates of the LED in the BTBeacon’s port 3. BlackTrax Wiki 236 of 298 5/14/2019...
Page 237: Beacons
These settings will override any assignment made on the Beacon Patch page. To assign a BTBeacon, Mini Beacon, Rigid Frame or Soft Frame to a Trackable for a speciﬁc chapter In the Chapters tab, select the chapter the Trackable is in. BlackTrax Wiki 237 of 298 5/14/2019...
Page 238 Trackable for the speciﬁc chapter. A book icon will appear next to the Assignment setting in the Trackables section. Note: To revert back to the globally assigned BTBeacon, click the Book icon. For the changes to take eﬀect, click Apply Changes. BlackTrax Wiki 238 of 298 5/14/2019...
Page 239: Messages
Only Appears For Errors and Warnings checkbox. Click OK. To clear all information In the Messages widget, click Clear. Result: The Messages widget will be cleared of all the information listed. BlackTrax Wiki 239 of 298 5/14/2019...
Page 240: System Log
System Log System Log widget displays system information about the BlackTrax project. The various features of the system log are: Enable Logging: Select this checkbox to log all events in System Log widget. Data: Select this checkbox to record all data transmitted. Used primarily for debugging purposes.
Page 241: Project Properties
Note: The Merging Channel is a single DMX channel that is patched into your lighting console to enable the control of moving ﬁxtures from BlackTrax. This can be a dimmer channel that controls intensity fading between BlackTrax and the lighting console, or a simple On/Oﬀ...
Page 242 Project Properties widget, in DMX Input section, select from the Source drop-down menu. Result: The selected source will set the DMX input for the Chapter Control Channel of the BlackTrax project. To set the universe and chapter control channel Open the Project Properties widget.
Page 243: System Conﬁguration
System Conﬁguration System Conﬁguration widget is where BlackTrax software behavior can be conﬁgured. System Conﬁguration Widget System Conﬁguration widget displays the following buttons to access the sections: System: System prompts can be toggled On or Oﬀ. See Editing section page.
Page 244: System Section
(minutes): Select this checkbox to enable, and set the duration of Auto Saving of the .btprj associated with a Portfolio. Auto Save can happen anywhere from 5 minute to 30 minute intervals, and the timer is activated by editing changes in the BlackTrax GUI.
Page 245: Fixture Calibration Section
Use calibrated ﬁxture position for zoom/iris control: Select this checkbox to use the calibrated zoom and iris settings of the ﬁxture that was calibrated in BlackTrax. Clear this checkbox to use the zoom and iris settings applied to the ﬁxture as drawn in BTWYSIWYG.
Page 246 Frame Calibration section Frame Calibration: Click on the Updating oﬀsets interval (seconds): scroll box to set the time interval for the Centroid and Orientation Oﬀset values to be applied to the selected Rigid Frame. BlackTrax Wiki 246 of 298 5/14/2019...
Page 247 WYSIWYG: Select this checkbox to enable the selection of ﬁxtures in WYSIWYG from BlackTrax. Allow incoming selection from WYSIWYG: Select this checkbox to enable the selection of ﬁxtures and trackables in BlackTrax from WYSIWYG. Send tracking information to WYSIWYG: Select this checkbox to send information from BlackTrax to WYSIWYG.
Page 248: Cameras Section
Changes. There is a large range that you may use, so it is best to step the ﬁeld by either +0.1 or -0.1 each time to see if the noise becomes better or worse. BlackTrax Wiki 248 of 298 5/14/2019...
Page 249: Beacons Section
(milliseconds): Click on this scroll box to set the time (in milliseconds) it takes for the calculated centroid updating to complete when a Stringer contributing to a centroid becomes hidden, or is visible again in the BTSensor view. The shift will be smoother (but takes more time to complete) when the timing is longer.
Page 250: Output Conﬁguration
Output Conﬁguration widget Output Conﬁguration widget displays the following sections: Active Outputs: The list data and settings of created outputs for the current BlackTrax project. Active Outputs page. Edit Output: The section for managing the network connections of the selected output. See...
Page 251 Active Outputs The Active Outputs section displays the list of output connections that are detected by the BlackTrax System. The connection settings and output statuses for every active module can be monitored via the Active Output table. Active Outputs section...
Page 252: Edit Output
Notes: When a project is opened in a server that is missing the saved NIC, BlackTrax will ask what NIC you would like to use for each output. When BlackTrax detects an IP change in Windows, the...
Page 253 Precision: Click this scroll box and set the decimal point precision for the X, Y, Z values coming out of the RTTrPM. Apply: Click to apply the settings. Note: As a general rule, click Apply Changes to apply all changes that you set in Output Conﬁguration. BlackTrax Wiki 253 of 298 5/14/2019...
Page 254 When you patch a Beacon or Mini Beacon or Rigid Body Frame or Soft Body Frame to a Trackable, a BlackTrax output sends the name of the Trackable (for example Luke instead of 1). The position and orientation of the Trackable is generated from the Beacon or Frame that is patched to it.
Page 255 If a Beacon or Frame is patched to a Trackable, the Beacon or Frame will not be available for selection to enable in their respective tab. Rigid Soft bodies display their name instead of Beacon ID. Click Apply Changes to apply all changes that you set in Output Conﬁguration. BlackTrax Wiki 255 of 298 5/14/2019...
Page 256: Output Options
Output Options The Output Options section is where Trackable data that is being sent can be altered. Attention: The settings aﬀect Output Modules that are sending data from BlackTrax, and applies to RTTrPM outputs. Trackable Settings tab: Set tracking smoothing response for a single or multiple trackables. The...
Page 257 This creates imperfect data or noise. Filtering the data is a way to correct any noise that enters the data. Enabling Output Raw Position, or disabling Acceleration and Velocity will de- activate the smoothing slider from the Trackable Settings tab. BlackTrax Wiki 257 of 298 5/14/2019...
Page 258: Output Conﬁguration Settings For Third Parties
LED: Checked Centroid: Unchecked Orientation: Unchecked Timestamp: Checked Acceleration and Velocity: Checked Green Hippo Edit Output > Advanced Coordinate System: Screen Integer: Big Endian (Network Order) Float Point: Little Endian (Intel Order) Orientation: Euler BlackTrax Wiki 258 of 298 5/14/2019...
Page 259 Checked Acceleration and Velocity: Unchecked Watchout Edit Output > Advanced Coordinate System: Stage (WYSIWYG) Integer: Big Endian (Network Order) Float Point: Little Endian (Intel Order) Orientation: Euler Output Options > Output Modules LED: Unchecked BlackTrax Wiki 259 of 298 5/14/2019...
Page 260 Unchecked Timestamp: Unchecked Acceleration and Velocity: Unchecked MRMC Flair Edit Output > Advanced Coordinate System: Screen Integer: Little Endian (Intel Order) Float Point: Little Endian (Intel Order) Orientation: Quanternion Output Options > Output Modules BlackTrax Wiki 260 of 298 5/14/2019...
Page 261 LED: Unchecked Centroid: Checked Orientation: Checked Timestamp: Unchecked Acceleration and Velocity: Checked WYSIWYG Edit Output > Advanced Coordinate System: Stage (WYSIWYG) Integer: Big Endian (Network Order) Float Point: Little Endian (Intel Order) Orientation: Quanternion BlackTrax Wiki 261 of 298 5/14/2019...
Page 262 Coordinate System: Stage (WYSIWYG) Integer: Little Endian (Intel Order) Float Point: Little Endian (Intel Order) Orientation: Euler Output Options > Output Modules LED: Checked Centroid: Checked Orientation: Checked Timestamp: Unchecked Acceleration and Velocity: Unchecked BlackTrax Wiki 262 of 298 5/14/2019...
Page 263: System Status Widget
Output to a DMX Merge node for sending to a physical lighting system Tracking Adapter Traker Input Internal input from Tracker for motion data RTTrPM Output to a third party using the RTTrPM protocol BlackTrax Wiki 263 of 298 5/14/2019...
Page 264 Latency does not account for any latency within Motive, from Stringer to BTSensor, or the network to the Third Party. Latency will increase slightly with more active Beacons, so when using this tool, ensure all Beacons you wish to measure are actively tracking before starting the test.
Page 265: Keyboard Shortcuts
Keyboard shortcuts Standardized BlackTrax keyboard shortcuts are deﬁned below: Description Keyboard shortcuts New Project Ctrl+N Open Project Ctrl+O Save Ctrl+S Apply Changes Ctrl+Enter Apply BTWYG Updates Ctrl+W Copy Ctrl+C Paste Ctrl+V Select All Ctrl+A Undo Ctrl+Z Undo Stack Ctrl+Shift+Z Redo...
Page 266: Record Tracking And Lighting Data
Record Tracking and Lighting Data This feature enables BlackTrax to automatically record tracking and lighting data in the form of packets while receiving incoming tracking data from Motive. This data will save in the C:\bt_run_time folder as a .rec ﬁle. The recording can be played back in the application.
Page 267 Simulator & Cue Modules Table of contents: Simulator Module Layout of the Simulator Module Cue Module Layout of the Cue Module Record and Playback Tracking Data in the Cue Module BlackTrax Wiki 267 of 298 5/14/2019...
Page 268: Simulator Module
The Simulator can send and receive simulated data to and from the other modules. The sections in the Simulator layout are: Beacon Conﬁguration Beacon Position Network Conﬁguration Message Log Simulator Module BlackTrax Wiki 268 of 298 5/14/2019...
Page 269: Layout Of The Simulator Module
You can also type the measurement values in the boxes beside to specify the rotation location and angle. R=Radius of the circle's movement, and A=Angle of the circle around the world coordinate system. Update: Click this button to apply the position and rotation values to the selected BlackTrax Wiki 269 of 298 5/14/2019...
Page 270 Data: Select this checkbox to display detailed packet information in the Message Log. Write to File: Select this checkbox to save the log as a text ﬁle in the C:\bt_run_time folder. Clear Log: Click this button to clear all messages in the log. BlackTrax Wiki 270 of 298 5/14/2019...
Page 271: Cue Module
Cue Module Module is where real-time or simulated tracking data in BlackTrax can be recorded as Time Stamp Frames that will be saved as Chapters and played back in sequence. The sections in the layout are: Motive Input Record Recording Mode/Show Mode...
Page 272: Layout Of The Cue Module
In this section, you can toggle between Recording Mode or Show Mode. Recording Mode: Saved ﬁles are created as Chapters and added to the table for editing and playback. Note: Click the Recording Mode button to toggle into Show Mode, which will display the list BlackTrax Wiki 272 of 298 5/14/2019...
Page 273 Load List: Click this button to load the list of saved Chapter(s) that were created and stored as a BlackTrax Cue File (.bcf) ﬁle. Save List: Click this button to save the list of Chapter(s) that were created in this module and added to the list in the table.
Page 274: Record And Playback Tracking Data In The Cue Module
In the Chapter Id box, enter the number for the chapter you want to create. The Chapter ID number will correspond and sync with the Chapter that you wish to recall and playback in the BlackTrax GUI. In the Name box, type the name that you want to add to the chapter that you will create.
Page 275 File (.bcf). Click Load List to load the list of saved Chapters that was created and stored as a BlackTrax Cue File (.bcf). Click Create Chapter to add a Chapter that consists of the ﬁle that has been accessed in the Chapter Content section.
Page 276 BlackTrax Device Manager Table of contents: BlackTrax Device Manager Device Manager User Interface 1.1.1 Introduction 1.1.2 Layout of the BlackTrax Device Manager GUI 1.1.3 Menu Bar 1.1.3.1 File Menu 1.1.3.2 Widgets Menu 1.1.3.3 Settings Menu 1.1.3.4 Help Menu Device Manager Widgets 1.2.1...
Page 277: Device Manager User Interface
Device Manager User Interface Table of contents: Introduction Layout of the BlackTrax Device Manager GUI Menu Bar File Menu Widgets Menu Settings Menu Help Menu BlackTrax Wiki 277 of 298 5/14/2019...
Page 278 Introduction The BlackTrax Device Manager is a software application where external hardware used in the BlackTrax system can be accessed and managed directly through a PC. In the Device Manager, ﬁrmware can be uploaded to the Charging Stations, Beacons, TimeKeepers and Routers.
Page 279 Layout of the BlackTrax Device Manager Device Manager displays the table of connected devices for TimeKeepers, Routers, and Beacons on the Main panel, the docking widgets for Device Settings, Charging Stations, System Log and the Charging Station Settings tab. Main...
Page 280 Widgets: Access to all the docking widgets, advanced mode and reset view toggle. Settings: Access to the Device Manager Conﬁguration module and the System Log widget. Help: About information for the current release of Device Manager. BlackTrax Wiki 280 of 298 5/14/2019...
Page 281 Device Manager File Menu Device Manager File Menu File menu is where you can close the Device Manager when you click File > Exit Device Manager. BlackTrax Wiki 281 of 298 5/14/2019...
Page 282 The docking widgets comprise of a 'ﬂoat' and 'close' function. Floating a widget will detach it from the GUI, and allow you to drag it around the screen, or to another monitor. The close function will close the widget, at which point you must re-open it from the Widgets menu. BlackTrax Wiki 282 of 298 5/14/2019...
Page 283 Device Manager Settings Menu Device Manager Settings Menu Settings menu provides access to the Device Manager Conﬁguration module and the System Log widget. BlackTrax Wiki 283 of 298 5/14/2019...
Page 284 Device Manager Help Menu Device Manager Help Menu Help menu provides access to the About Device Manager dialog box with information about the Device Manager, product version, and build number. BlackTrax Wiki 284 of 298 5/14/2019...
Page 285: Device Manager Widgets
Device Manager Widgets Table of contents: Main Panel Device Settings Charging Stations Charging Station Settings System Log Device Manager Conﬁguration BlackTrax Wiki 285 of 298 5/14/2019...
Page 286 The Main panel (center area) of the Device Manager displays the table of connected devices for the TimeKeepers, Routers, and Beacons that are connected to the BlackTrax. Click on the Device Type Filter drop-down to choose which type of device to display:...
Page 287 Wireless Channel. Click Apply. Result: The Wireless Channel is changed and the Current Preset displays Custom. On the Subnet scroll box, click the arrows and select the wireless Subnet number (or type a new BlackTrax Wiki 287 of 298 5/14/2019...
Page 288 Subnet number (or type a new number) that devices on the same Wireless Channel will use to communicate. Click Apply. In the Loaded Firmware section, a device ﬁrmware can be located, selected and uploaded into the selected TimeKeeper(s). BlackTrax Wiki 288 of 298 5/14/2019...
Page 289 The ﬁrmware update is complete, a checksum is performed to verify the upload. When checksum is complete, the device reboots. Status: Displays the current state of the ﬁrmware in the selected device. Not Ready (no ﬁle loaded) Ready (ﬁle loaded/previous ﬂash complete) BlackTrax Wiki 289 of 298 5/14/2019...
Page 290 Preparing...(jumping to boot loader) Flashing...(Actually ﬂashing the device) Verifying...(checksum) Finishing up...(jumping to main) BlackTrax Wiki 290 of 298 5/14/2019...
Page 291 201. The ID will always match the last octet of the IP Address (ID 201 = 10.133.5.201). Serial Number: The serial number of the hardware. IP Address: The network IP address where the Charging Station is connected. Status: Connected or Disconnected. Version: Firmware version. Notes: Other information. BlackTrax Wiki 291 of 298 5/14/2019...
Page 292 Status: Displays the current state of the ﬁrmware in the selected device. Not Ready (no ﬁle loaded) Ready (ﬁle loaded/previous ﬂash complete) Preparing...(jumping to boot loader) Flashing...(Actually ﬂashing the device) Verifying...(checksum) Finishing up...(jumping to main) BlackTrax Wiki 292 of 298 5/14/2019...
Page 293 This ﬁle is saved at "C:\bt_run_time\Device Manager". Auto Scroll: Select this checkbox to automatically scroll to the most recent data or event that has occurred. Clear: Click this button to clear all messages. BlackTrax Wiki 293 of 298 5/14/2019...
Page 294: Device Manager Conﬁguration
Firmware: Device Manager sets the device to jump to the main ﬁrmware. On the CS NIC Address scroll box, select the address for the Network Interface Card for the Charging Station that is connected to the BlackTrax System. Charging Stations are locked to the 10.133.5.x network.
Page 295: Common Functions Of The Device Manager
The use of Preset Beacon numbers acts as an easy and convenient way to conﬁgure all perimeters of Beacons without manually entering all settings. Connect the Charging Station to the BlackTrax System. Open the Device Manager. Note: All devices that are connected to the Charging Station are displayed in the...
Page 296 Charging Station Settings widget of the selected Charging Station, click Browse and select the ﬁrmware ﬁle and load into memory. Click Upload. Device Manager checks if the ﬁrmware matches the selected device and proceeds to update. BlackTrax Wiki 296 of 298 5/14/2019...
Page 297 Health and Safety Information Table of contents: BTBeacon Lithium-Ion Battery Information BlackTrax Wiki 297 of 298 5/14/2019...
Page 298 UN manual of Tests and Criteria, Part III, sub-section 38.3 (withstanding a 1.2m drop test). The content of Lithium is less than 100Wh per battery. The quantity per package is less then 10kg (gross) for UN3480. Thus the consignment is not classiﬁed as dangerous goods. BlackTrax Wiki 298 of 298 5/14/2019...

BlackTrax BTSensor Manual

Btsystem Components

Btwysiwyg for Blacktrax

1 Preparing the BTWYG File

2 Optional .BTX Information

3 Planning Btsensor Placement

4 Blacktrax Visualization

Motive for Blacktrax

1 Initial Setup

2 Btsensor Calibration

3 Tracking Mode

4 Recording in Motive

Blacktrax Gui

1 Before Using Blacktrax

2 Blacktrax User Interface

3 Live View

4 Editing View

5 Calibration View

6 Global Widgets

7 Keyboard Shortcuts

8 Record Tracking and Lighting Data

Simulator & Cue Modules

1 Simulator Module

2 Cue Module

Blacktrax Device Manager

Quick Links

Chapters

Need help?

Questions and answers

Summary of Contents for BlackTrax BTSensor