SPORTSTEC CODA User Manual
Contents Welcome to CODA© � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 8 CODA Overview � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 8 System Requirements � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 9 Current CODA Version � � � � � � � � �
m. Link Action Displays � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 28 n. The Code Mode Toolbar � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 28 o. Saving and Retrieving your Work � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 29 p.
a. Connecting to a Server � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 54 b. Creating a New Session � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 55 c. Connect to (Join) or Reconnect to a Session � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 56 d.
iCODA Preface � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 68 Current iCODA Version � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 68 Linking iCODA to a Command Centre � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 69 Activation in a WiFi Network � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �
Link Protocols � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 81 Create a link between Objects � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 82 Delete a link between Objects � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � 82 Inspector � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �
7
Welcome to CODA© Welcome to CODA© Quick, Live Event Coding CODA © by Sportstec is the latest addition to the Sportstec family of products. CODA © is designed to work in conjunction with Sportstec Gamebreaker, SportsCode™ and Studiocode™ video analysis systems, giving you activity and/or participant event coding capabilities previously only dreamed of.
System Requirements System Requirements The minimum recommended system requirements for CODA are : Apple Computer with 1.5GHz or faster PowerPC G4 , PowerPC G5 , Intel Core Duo or Intel Xeon processor 1 GB of RAM 50MB of HDD space A display with 1024 x 768 resolution or higher Mac OS X v10.4.11 or higher (Optional) Tablet and pen Current CODA Version The current version of CODA which this Manual applies to is Version 2.0.
CODA Support & Feedback • To register your CODA application online, click the “Register” button. • Enter your Registration Code and click the “Register” button. If you have a Firewall that won’t allow you to register online, you may register manually. To effect this process, click on the “Register Manually” button. CODA will provide you with a Licence code. Email this code to admin@sportstec.com to receive an Activation Key.
Using this Manual Using this Manual Sections 1 & 2 describe the functions which each of the Icons on the Toolbar performs. Sections 3 – 8 describes how to create building blocks on your CODA Form. Sections 9 – 11 describe how to assemble your building blocks into a working CODA model. Section 12 describes coding your activity and editing the data. Sections 13 - 15 describes how to link CODA desktop to iCODA (iPad, iPhone or iPod Touch). Section 16 describes how to interpret the Data.
The Main Menu Bar The Main Menu Bar CODA has been written so that all the functions required of the application may be accessed from the CODA Toolbar or by Control Click (right clicking) on menu links. For the purpose of this manual, the functions of each of the Main Menu Headings in the Main Menu Bar are summarized below. CODA: With this Heading, the functions are limited to: a). Registration & deregistration of your CODA licence. b). CODA version updates. c).
1. The CODA Toolbars When you place (hover) your cursor over each of the toolbar icons, a message will appear which describes the function of the icon when you click on it. You may open a new CODA Window by selecting “FILE” from the Main Menu then selecting “New Form”. A CODA window becomes a CODA Form when you start placing coding objects in it. You may open an existing Form by selecting “Open Form” or “Open Recent” and selecting your target Form from where it is saved.
1. The CODA Toolbars The Function and Purpose of each of the Toolbar Icons is as follows: a. Events When you place your cursor arrow over the Event icon the “Add an Event to the Form” message appears. When, (and each time,) you click on this icon an Event button will be placed in a descending vertical sequence on the left hand side of the CODA Form. By default an Event button will be colored blue. This will have a default caption “Event” in the centre of the button.
1. The CODA Toolbars An alternative method is to select the Event button, Control Click and select “Add Popup Tag”. A Popup Tag button can be moved to any location in the CODA Form by clicking on the Popup Tag button and dragging it to the desired location. The Popup Tag Mat which surrounds the Event button and the Popup Tag button(s) will distort to remain linked to its Event button. Popup Tag buttons are always only attached to one Event button.
1. The CODA Toolbars of the Link properties is to pass the Tag information forward. Refer to para. 9 below for more detailed information on this property. d. Shape When you place your cursor arrow over the Shape icon the “Create a new Shape” message will appear. When, (and each time,) you click on this icon a Shape button will be placed in a descending vertical sequence in the CODA Form.
1. The CODA Toolbars The Counter has 3 functions to choose from when the Counter is linked to an Event button. Refer to paragraph 1.j (vi) h. Container When you place the cursor arrow over the Container icon the “Create a new Container” message will appear. When, (and each time,) you click on this icon a Container Form will be placed in the CODA Form. Be mindful that if a Container is selected, any objects created will be placed inside this container.
1. The CODA Toolbars Properties Windows There is no Properties Window available for a Shape button or a Container.
1. The CODA Toolbars j (i) Name an Event, Popup Tag or Tag Button This function is the same for Event buttons, Popup Tag buttons and Tag buttons. With the button highlighted, in the “Code Name” panel of the Inspector Properties function, type the caption that will describe the Event and for Popup Tag and Tag buttons, the caption that will describe related actions.
1. The CODA Toolbars j (ii) Event Time Tweaks This is a function for Event buttons only. You have complete control over the duration of each event you code. Using the Lead and Lag Times means you can program CODA to automatically add a specific time to the beginning or end of an event marked for the purpose of editing a video when CODA is linked to a timeline in the Sportstec Gamebreaker, SportsCode™ or Studiocode™ application.
1. The CODA Toolbars j (iv) Hot Keys This function is the same for Event buttons, Popup Tag buttons and Tag buttons. You may choose to attribute a keyboard Hot Key or a combination of keys to any button. This will allow you to use your mouse and/or your keyboard to activate a button while you are coding in a live environment. To provide for this option, click on the Text box from the “Hot Key” panel at the bottom of the Inspector window and then type in your keyboard option preference.
1. The CODA Toolbars Appearance Windows The Appearance Window for an Event button is illustrated at left. The Appearance Windows for a Popup Tag and Tag are the same as for an Event button except there is no Popup Tag Mat section. The Appearance Window for a Shape button has all the functions that an Event has except for the Text Attributes, the ability to bevel the button and the Popup Tag Mat. The Appearance Window for a Text Box and a Counter provides Text Attributes and Geometry options only.
1. The CODA Toolbars j (vii) Button Shapes and Images This function is the same for Event buttons, Popup Tag buttons, Tag buttons and Shape buttons. If you wish to graphically represent different button events you may change the shape of a button or import an image to use as the button. A button may also be made transparent for use with more advanced coding. The following 4 shape options are available within the drop down menu. These shapes may be manipulated by using the re-sizing knobs.
1. The CODA Toolbars You may also choose to use an image as a button. With the button highlighted open the “INSPECTOR” and from the “Shape” panel drop down menu select the “Filled Images” option. Then from the “Fill” panel select “Image”. A File List window will open. Navigate to and select the image you wish to use and double click on it. The image will replace the target button. If you wish to change an image, highlight the button and from the “Fill” panel select “Choose Image”.
1. The CODA Toolbars j (ix) The Stroke Panel – Button Presentation This function is the same for Event buttons, Popup Tag buttons, Tag buttons and Shape buttons. The “Stroke” panel scribes a border outline around the button. By default the Stroke is the same color as the button background. If you click on the horizontal bar in the Stroke panel you will have 4 border pattern options to choose from. If you click on the colored panel underneath the “Stroke” box, a color chart will appear.
1. The CODA Toolbars j (xi) Geometry This function is the same for Event buttons, Popup Tag buttons, Tag buttons, Shape buttons, Text Boxes, Counters and Containers This function allows you to vary the position of an object and the size of an object in the CODA Form or within a Container Form very precisely. If you highlight the target object, the objects position in the Form will be precisely described with reference to the top left hand corner of the object from the top left corner of the Form.
1. The CODA Toolbars There are 3 function features common to all the 5 palette choices which will assist you in enhancing the coding of your CODA Form. The “magnifying glass” symbol at top left beside the color bar can be used to capture a specific color hue from anywhere. By clicking on the symbol it will become your cursor. Next place this modified cursor over the color you want to use and click on it.
1. The CODA Toolbars selections in the drop down menu. To change the text color in this menu routine click on the color box and choose the color from the palette choice. For more detailed color options refer to para. 1.k above. m. Link Action Displays The icons represent the “Outbound Action Links” (on the left) and the “Inbound Action Links” (on the right). By default, for a button which has no links, the “On Activate” and “On Deactivate” actions will be listed in the Outbound Action Links display.
1. The CODA Toolbars o. Saving and Retrieving your Work If you have edited or added to your CODA Form the red button in the top left hand corner of the Toolbar will indicate this by displaying a dot in its centre. Click on this red button and the following window will drop down to confirm your intentions. Or you may select the “Save Last Coding Form As...” from “FILE” in the Main Menu.
2. Button Resizing & Reshaping p. Password Protection You may place a password protection on a Code Form to either protect the form at opening or to protect the design of the form from being altered after opening. To place a password protection on your form, click on a blank area of the coding form then open the Inspector. Input and verify your password, then select the option for where you want the password protection to apply.
2. Button Resizing & Reshaping 2. Button Resizing & Reshaping To re-size a button click on the button to display the re-sizing knobs. By clicking on a corner knob, you will anchor the button on the diagonally opposite corner and then you are able to drag your selected knob in any direction to change the shape and size of the button.
3. Getting Started 3. Getting Started It is assumed that you have read and understood the information contained in the preceding Chapters of this Manual before progressing to applying the functions of the software tools to Coding. Building a CODA Form When you open CODA from the Dock or from the Application Icon on the Desktop the CODA Window will open. This window will be blank if you have not selected to “Show Document Startup Dialog” from the “Preferences” sub-menu in “CODA ” on the Main Menu bar.
4. Creating and Specifying an Event 4. Creating and Specifying an Event Select “EVENT” from the Toolbar to open/create an Event in the CODA Form. Click on the Event in the CODA Form to identify it. It will become surrounded by re-sizing knobs to indicate that it is selected and then go to the “INSPECTOR” icon on the Toolbar. You should now name the event and also specify all the CODA Form parameters which the Inspector function describes. Be sure to include the Event Time Tweaks details (refer to para. 1.
5. Creating and Specifying a Popup Tag 5. Creating and Specifying a Popup Tag A Popup Tag cannot be created unless an Event is selected which the Popup Tag will be attached to. Select the Event you wish to attribute a Popup Tag to by clicking on it and then click on the “POPUP TAG” icon on the Toolbar. A Popup Tag will open in the CODA Form within a Popup Tag Mat which surrounds the Popup Tag(s) and the Event it is attached to.
7. Importing an Image to the CODA Form In the illustration below, the Tags have been given an elliptical shape as well as a distinctive color. They are outside the Tag Button Mat and so they are independent of the Event but may still be “attached” to it as a further description. Reconfiguring Tag and Event buttons You may have created a Tag and then subsequently decided that it would more appropriately function as an Event or vica versa.
8.Duplicating CODA Form Combinations 8.Duplicating CODA Form Combinations If there are button combinations which you wish to duplicate, it is possible to duplicate a button combination in the same CODA Form. There are 3 ways this may be achieved. 1. Control Click on the Event button for the combination you wish to duplicate and from the drop down menu select “Duplicate”. To move the duplicated button click on the centre of the button and drag it to the desired location.
Advanced Functions Summary Now you have a CODA Form for the hypothetical activity in which you have created 3 Events and filled the Event buttons with the images for each. Each Eventbutton has 3 Popup Tags and 2 Tags. You have grouped the Popup Tags by color, you have named them all to describe their various event descriptors and possible outcomes; and the Tags, (which may be selected at random as non-associated event descriptors,) are differentiated by a distinctive elliptical shape.
Advanced Functions Advanced Functions You will appreciate that within your chosen activity, there will be that activity’s unique events and possibly also a variety of unique resultant event permutations depending on how the activity develops.
9. Links Terminology An “On activation” link will perform when the source button (Event, Popup Tag or Tag) is activated. An “On activation “ link originates from the source button icon which is located on the left side of the button. An “On activation” link is depicted on the Coding Form as a green link line. An “On deactivation” link will perform when the source button (Event only) is deactivated.
9. Links To display a links properties click on the link. The property(s) displayed will be in reference to the button which is highlighted. Remove a Link To remove a link highlight the button and open the Inspector. Select the relevant Inbound or Outbound Links icon then select and highlight the link from the relevent (On Activate or On Deactivate) column and click the X icon in the row or click on a displayed link and click the X in the link descriptor displayed. b.
9. Links To identify which buttons in the CODA Form are members of an “Exclusive Link Cluster”, click and hold on an Event button. If that button is a member of an “Exclusive Link Cluster” it will be backlit by a rose colored hue and every other Event button which is a member of that cluster grouping will also be backlit. A button can only be assigned to one (1) Exclusive Link Cluster.
9. Links An “On-activation Link” has been created from the “Replaced “Tag button to each of the Event buttons with the target button instruction to “Tag and Deactivate”. Similar links have been created from the “Discarded” Tag button to each of the Event buttons. 6 Links in total.
10. CODA Form Management 10. CODA Form Management a. Arranging the Form in Layers If the CODA Form you have built becomes large, it is possible that it will not fit within the boundaries of your screen. This could cause a problem later when you are coding the activity. If this is the case, it is possible to begin stacking buttons in the CODA Form in layers one behind or one in front of the other. You may stack as many buttons as you wish.
11. Email a Form c. The Container The Container is a device which functions in a “popup” manner and which contains coding objects. The primary function of the Container is for organising the coding form to allow complex code forms to exist within limited screen real estate. There may be containers within containers. A container will act as a separate coding form. coding objects within it. Click on the Container icon in the toolbar to create a Container in a coding form.
12. Coding an Activity 12. Coding an Activity Once the SportsCode™ / Studiocode™ CODA Template / CODA Form has been completed you are ready to begin coding an activity. Click on the “Code” option on the CODA Toolbar to go to Code Mode. You will be offered a window to save your design work. We strongly recommend that you save your design work before you begin any coding activity. The Coding Mode Toolbar illustrated below will appear and your CODA Form will be displayed in “opaque” format.
12. Coding an Activity This window will sequentially record the Events which have been activated as they are activated, (either from the User pressing the Event button or as a result of a Link,) and display if an Event is still active. It will also record the start and end time on the timeline for each Event marked. You may choose whether or not to display the Coding History window by clicking on VIEW in the Main Menu and selecting “Show/Hide Coding History”.
13. CODA Command Centre 13. CODA Command Centre Linking CODA Desktop to iCODA, the Command Centre allows you to connect to an iCODA application installed on an iPad , iPhone or iPod Touch; activate or deactivate the iCODA application and transfer CODA Forms and Output Files. The Command Centre also allows you to establish a CODA Server. Note: The Command Centre will only link to iCODA and visa versa. iCODA is exclusive to iPhone, iPad and iPod Touch.
13. CODA Command Centre Activate iCODA for a Mobile Device There are 2 ways to activate iCODA for a mobile device to connect it to your CODA application through the Command Centre. The first is for devices which are connected to your WiFi network, and the second is for devices which are remote. To Allocate an iCODA Activation for a Mobile Device Connected to your WiFi Network When CODA detects a mobile device in it’s network, this device will be be listed in the DEVICES section at the left of the page.
13. CODA Command Centre To name the Device User, the device must logout of and relaunch iCODA. Then in your Command Centre click the Refresh button and the Device name will be displayed. To Deactivate an iCODA Activation from a Mobile Device Connected to your WiFi Network To deactivate an iCODA activation in use by a mobile device which is connected to your WiFi network, click on the device name in the DEVICES list to highlight it.
13. CODA Command Centre Copy the iCODA ID from the email received from the Device User into the iCODA ID Field. ( Refer to the iCODA Manual on page 70 for procedure instructions ) You may also enter any comments in the free text field. These comments will be displayed with the User information when you click on an allocated iCODA activation. Click the “Activate” button. The highlighted Activation icon will turn orange to indicate that it has been allocated and activated.
13. CODA Command Centre Working in the Command Centre After the device has been successfully activated, the Activation tab view will contain information about the used for the device. The panel on the right of the Mobile mode window will display all the files stored on the active mobile device selected in the left hand panel. See the illustration below. These file lists will be empty if you have just activated your new iCODA application.
14. The CODA Server 14. The CODA Server The CODA Server is a feature that allows any number of CODA and/or iCODA applications to participate in a synchronized coding session simultaneously and live via the internet. The basic premise of this feature is that there must be a common receptacle for the coded information. The Coda Server must be established through the CODA Command Centre to perform this task.
15. Network Coding By default, Port 8080 is specified. If that port is in use, you will get an error message “ The port for this IP address is already in use” You will be required to either stop the service which is using that port, or select another port. The “Sessions Root Folder” is the file path for the root folder of where the system will store the coding session timelines. CODA will specify a default file path culminating in the file named “Coda Sessions” .
15. Network Coding 15. Network Coding Network Coding is a feature that allows any number of CODA and/or iCODA applications to participate in a synchronized coding session simultaneously and live via the internet. The CODA XML data file which is created from the multiple coding inputs is available to be pulled into SportsCode or Studiocode in real time.
15. Network Coding These details should be provided to you by whoever has established the Server. If any details are incorrect you will get a “Connection Failed” message. Once you have established a Server connection either by selecting and clicking on the Server name from the Server list or by connecting to a new Server, select the Session (by Session Name displayed,) or you may create a new Session. b. Creating a New Session From the “Session List” click the “New Session” option.
15. Network Coding c. Connect to (Join) or Reconnect to a Session From the Session List panel, highlight the session you wish to join and click the “Join” button. If a password is required, input the password and click “Join”. If the password is correct, you will join the session and you will be taken directly to the Coding Form in your Code Mode. Turn the Network switch ON.
15. Network Coding e. The Session Owner The person/device which creates a session is the “Owner” of the session. The key function which the owner must perform is to “Start” a coding session. No other participant is able to start a session. f. Start Coding Once the session owner has started the session, the Code Mode screen will become clear and you may begin coding. If the session is in progress when you join, the Code Mode screen will be clear and immediately available for coding. g.
16. Exporting your Coded Data h. Disconnect from / Stop a Session You may deliberately disconnect from the session at any time by clicking the “Stop” icon button in the Code Mode toolbar. If the Online Coding status indicator which is located on the Coding Session Timer changes from green to red during an online coding session, this indicates that the connection to the server has been broken. CODA will automatically attempt to re-establish the connection.
16. Exporting your Coded Data 16. Exporting your Coded Data Interpreting CODA Event Log Data CODA is designed to be used in conjunction with the SportsCode™ / Studiocode™ Analysis products. For details of how to import the CODA Event Log into these products and for information on how to manipulate the resultant data please refer to the relevant SportsCode™ / Studiocode™ User Manual.
Appendices (i) Keyboard Quick Key Functions MENU ITEM – FUNCTION KEYSTROKE COMMAND ⌘ CONTROL OPTION SHIFT LEFT RIGHT ARROWS CLICK ⌃ ⌥ ⇧ ↑↓ � FILE New Open Close Save Save as Page Setup Print ⌘N ⌘O ⌘W ⌘S ⇧⌘S ⇧⌘P ⌘P EDIT Undo Redo Cut Copy Paste Select All Copy Style Paste Style Special Characters ⌘Z ⇧⌘Z ⌘X ⌘C ⌘V ⌘A ⌥⌘C ⌥⌘V ⌥⌘T WINDOW Minimize 60 ⌘M
(i) Keyboard Quick Key Functions ARRANGE Bring Forward Send Backward Bring to Front Send to Back Lock Position Unlock Position ⌘↓ ⌘↑ ⌥⌘↓ ⌥⌘↑ ⌥⌘L ⌥⌘U VIEW Show Fonts Show Colors Show Inspector Show All Hot Keys Show Coding History Hide Popup Tags ⌘T ⇧⌘C ⌥⌘I ⌘K ⇧⌘H ⌥⌘E CODA Preferences Command Centre Hide CODA Hide Others Quit CODA ⌘, ⌥⌘C ⌘H ⌥⌘H ⌘Q MAC OS X Selection snap shot to memory 61 ⇧⌃⌘4 ⌘V to paste to another window
(ii) Glossary of Terms (ii) Glossary of Terms Main Coding objects Code button - A visual object represented by a particular shape or image.
(ii) Glossary of Terms Exclusive link cluster - A logical group that includes member events Properties: Pass Last Event’s Code Functions: turns members off can pass the last Event’s code on to the next activated member Other objects and terms Instance - A passage in time, created by a particular event Properties: Start Time End Time Code Name Labels Active instance An instance that has been created, but has not been closed yet. It has an empty End Time property.
(ii) Glossary of Terms Code buttons can receive messages: pushDown - the message is initiated when the user presses a code button. doActivate - the message is initiated by a link. doDeactivate - the message is initiated by a link or exclusive link cluster. doReactivateLagTime - the message is initiated by a link. doLabel - the message is initiated by a link or tag. This message contains a code stack.
(ii) Glossary of Terms Popup tag receives a pushDown message: Creates a code stack and adds its code to it. Sends a doLabel message to its master event. Sends a initiatorDidTurnOn message to all outgoing links. Link receives a initiatorDidTurnOn message If the Activate Target On Activate property is set on the link sends a doActivate message to its target.
(ii) Glossary of Terms 66
SPORTSTEC iCODA User Manual
iCODA Preface iCODA Preface iCODA is an application exclusive to the Apple iPhone, iPad and iPod Touch. iCODA will link to the CODA Command Centre and vica versa. iCODA will also link directly with SportsCode and Sportstec Gamebreaker for Timeline exports. This manual describes the principles and techniques you need when using iCODA. For a more detailed description of CODA functions, consult the CODA User Manual. ICODA supports the operating Sysytem for iPhone 3GS, iPhone4, iPod Touch and iPad.
Linking iCODA to a Command Centre Linking iCODA to a Command Centre Once you have downloaded your iCODA application from the Apple Store it will operate in Demo mode. In demo mode iCODA will function normally, but it will need to be linked to a CODA Command Centre to perform the Command Centre functions of Online Coding and data transfer. You may link iCODA either by being connected to the WiFi network of the host CODA Command Centre or remotely if you are not connected to the host WiFi network.
Linking iCODA to a Command Centre Remote Activation The computer hosting the CODA Command Centre and the Mobile Device. must be able to communicate in order to convey the iCODA ID for the Command Centre to input. To link an iCODA license in the Command Centre to a remote device, the device must first send its iCODA ID to the CODA Command Centre, either by email, SMS or other means.
Navigation between iCODA screens Navigation between iCODA screens In the iCODA application there are 4 Operating Modes. These are the List Mode (Lists Forms or Timelines) ; Design Mode (which includes the Inspector window) ; Code Mode and Timeline Share (Email a Timeline). You can navigate between them at any time by using the relevant navigation bar at the top of the screen, or by using the tab bar at the bottom of the screen.
Gestures Gestures iCODA employs the following gestures: single tap, slide, double tap, resize. Each of these gestures performs a particular action on the target object. Single tap The single tap gesture is what you use to select buttons. It is performed by tapping an object once without moving your finger before you release it. In Design mode a single tap is used to select an object allowing you to “arrange” links etc. in Code mode use a single tap to activate/deactivate coding objects.
Objects Objects The following objects can be created in iCODA. See CODA Principles in the CODA manual for a detailed description of the objects and the coding process. Event Button An Event Button is a coding object that opens and marks the log of Events in the Edit List when it is activated and closes the log after it has been deactivated. An Event Button can be both the initiator and target of a Link.
Objects Container A Container is a form object. It behaves in the same way as a Coding Form and thus becomes a Form within the Form (but it will have no name). Containers may be placed within containers. The purpose of a Container is to manage the available screen real estate for your coding form. Counter A Counter is a dynamic graphical object which is linked to an Event or a Tag button. It will display one of three options.
List Mode List Mode In List Mode you may “flip” between Forms and Timeline Lists by tapping the relevant tab in the tab bar at the bottom of the screen. The Forms List contains all the coding Forms previously created in iCODA or uploaded from CODA using the Command Centre function. (Refer to page 50 of the CODA User Manual) Importing Forms into iCODA cannot be initiated by iCODA. The Form Name is preceded by a thumbnail picture of the form.
List Mode Password Protection You may place a password protection on a Code Form to either protect the form at opening or to protect the design of the form from being altered after opening. To place a password protection on your form, click on a blank area of the coding form then open the Inspector.
List Mode Edit a Form Name or Timeline Name Tap the Edit button in the upper-right of the Form or Timeline List to switch the List to Edit mode. Tap the Form or Timeline name to make the Rename dialog screen appear. Rename the Form or Timeline.. Tap the “Done” button or “return” button to accept the changes.
List Mode Receive a Form by Email Forms attached to emails can be opened and stored in iCODA. Select the attachment (tap the attachment or swipe the arrow to the right), if iCODA is installed a popup menu will appear with the option to “Open in iCoda” or to Cancel. Upon opening, the form attachment will automatically be copied into the iCODA Form List.
Design Mode Design Mode Design mode allows you to modify your Form both when a coding session has not been started and during the active coding session. Within Design Mode you will find the Inspector window which will allow you to modify properties of the Code window objects. Warning: If you decide to modify a Form during a coding session, you should be careful. Changing or removing any coding objects that have already been used in the timeline may lead to data inconsistency.
Design Mode Insert a new Object To add new objects to the Form tap the Insert button on the baseline toolbar. In the popup menu, (refer to the list of objects on page 67,) tap your selected object. The new object will be created on a vacant space in the screen or in the middle of the screen if there is no free space. The selection menu will collapse after each selection except for a Popup Tag selection. To collapse the popup without selecting an object, just tap the Insert button.
Links Arrange Objects Every object on the screen has its own Z-position, ie. an order of objects along the Z-axis, which is perpendicular to the screen. Consider each object as a single sheet in a stack. When the Form is being constructed, by default, the objects are arranged in order from the top of the Form with each new object being added beneath the last one on the Form, but ahead or in front of the former object in the Z-axis.
Links – from a Popup Tag button to an Event button or to a Tag button A Link cannot be established : – from an Event button to a Popup Tag button – from a Tag button to a Popup Tag button – from a Popup Tag button to a Popup Tag button Terminology An “On activation” link will perform when the source button (Event, Popup Tag or Tag) is activated. An “On activation “ link originates from the source button icon which is located on the left side of the button.
Inspector Inspector The Inspector window display depends on the object type and it allows you to modify the corresponding properties of that object. The Inspector Screen for the iPhone is a single display which contains all the Inspector functions. Scroll up or down by swiping the screen. Double tap an object on the form and the Inspector screen for that object type will open.
Inspector Caption The Caption bar allows you to manipulate the visible representation of the object’s code name on the screen. You can switch it on/off and shift it horizontally and/or vertically from the object’s center. Even if the caption’s visibility is switched off, it will not affect the coding process, coding objects will mark coded instances with their Code Name. This bar is displayed for Events, Tags and Popup tags. Shape The Shape bar allows you to specify the shape of the object.
Inspector Text & Attributes The Text & Attributes bar allows you to modify text attributes of the selected object, such as color and alignment. This tab is displayed for linked text boxes only. Geometry The Geometry bar manages the coordinates and the size of the object’s frame. It also allows you to lock the frame, preventing it from further changes. This tab is displayed for Events, Tags, Popup tags, Shapes and Text boxes. Actions Tap the text box to open the Actions display.
Inspector Tag Group The tag group property sets the parent group for the tag. A tag button can only belong to one group, but a group can contain as many tags as required. Using tag groups is recommended as it helps organize and sort tags when using the Matrix, Sorter and Find windows in SportsCode. When using the tag groups, try to avoid using tags that belong to the same group when coding a single event. This can create sorting problems in the Sorter window of SportsCode.
Code Mode Code Mode Use this mode for coding ie. to create a timeline. Only the single tap gesture is used in Code Mode. iCODA supports multi-task and fast app-switch on iOS4.1 During a coding session, if you choose to answer a telephone call or respond to other notifications, your coding session will automatically be suspended. iCODA will save your coding and will return you to the Coding Form and current coding session as soon as you terminate your call.
Code Mode To start a new coding session with the opened Form tap the Start button on the baseline and a timeline will be activated. To code, simply tap the relevant button(s). A coding session timer will appear at the right hand side on the baseline toolbar (see Figure B) and begin recording the elapsed time. In the centre of the Baseline is a lock / unlock button. Click this button to lock the position of the code buttons on the Coding Form.
Code Mode This display has a “pin-wheel” which can be scrolled to edit the Event start and end times in the Timeline. An Event may be deleted from the History by swiping the Event name from right to left and then tapping the Delete button. NOTE : Caution - This delete function is not reversible Tags attached to an Event may be added and/or deleted. To Add a Tag, tap the “Add a Tag” bar and select the Tag you wish to add from the list displayed.
Code Mode Stop the coding session When your coding has been done (completed), you stop the current coding session by tapping the Stop button on the toolbar. You will be asked to confirm your intention in the dialog sheet which appears by tapping the Stop Coding button. If you have tapped the Stop button by mistake, you may return to your coding screen by tapping the Coding Form. The coding session timer will still be active until you have confirmed your intention to stop coding.
Online Coding Online Coding Online Coding is a feature that allows any number of CODA and/or iCODA applications to participate in a synchronized coding session simultaneously and live via the internet. The CODA XML data file which is created from the multiple coding inputs is available to be pulled into SportsCode or Studiocode in real time.
Online Coding If, by default, you have been taken to the first available server in your Server List, (which will automatically list all the sessions available at that time on that server), but this is not the server you wish to connect to, tap the “Servers” button at the top left of the screen and you will be returned to the Servers List. Tap the server you wish to connect to.
Online Coding Create a New Session From the ‘Session List” tap the “New Session” option. The device which creates a new session will become the owner of the session and will be required to start the session. It is mandatory when creating a session to provide a session name. You may also choose to establish a password, without which other participants may not join the session. Tap “Done” to create the session.
Online Coding If the session has not been “Started”, the Code Mode screen will be “greyed out” which will prevent you from activating any code button(s), but you will still be connected to the session. A spinning wheel symbol will indicate that you are connected and that you are waiting for the session to start. There is an Online Coding status indicator located on the Coding Session Timer which indicates that you are connected to the server if it is green. When the connection is broken it turns red.
Online Coding Start Coding Once the session owner has started the session, the Code Mode screen will become clear and you may begin coding. If the session is in progress when you join, the Code Mode screen will be clear and immediately available for coding. Session Timer and Synchronization Once a session has been started, all the session participants, (including the Session Owner,) become equal participants as far as the CODA server is concerned.
Online Coding Disconnect from / Stop a Session You may deliberately disconnect from the session at any time by tapping the “Disconnect” button at the bottom right of the Code Mode screen. If the Online Coding status indicator which is located on the Coding Session Timer changes from green to red during an online coding session, this indicates that the connection to the server has been broken. CODA will automatically attempt to re-establish the connection.
Email a Coding Form Email a Coding Form You must have an active email account setup as a pre-requisite of this function. If you have more than 1 email account, the default email account will be used. To email a Coding Form, in the Forms List tap the Coding Form to select it, then tap the Email button. In the email screen, tap the address line ( To: ) to activate the addressee edit screen.
Email a Timeline Email a Timeline You must have an active email account setup as a pre-requisite of this function. If you have more than 1 email account, the default email account will be used. To email a Timeline, tap the Timeline Name to select it, then tap the Email button. In the email screen, tap the address line ( To: ) to activate the addressee edit screen. Enter the addressee details either by tapping the symbol to activate your Address Book, or by typing the details from the keyboard , ..........
