Versions Compared

Version Old Version 1 New Version Current
Changes made by

Christian Schabasser

Christian Schabasser

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Table of Contents

There are different Metadata Types:

  • Selection: drop-down box, containing several, user-definable <item> elements.

  • Text: text field.

  • Checkbox: checkbox, can either be unchecked off ("0") or checked on ("1").

  • Date: Date selection via a text input field or a “DatePicker”.

  • Time: Time selection via a text input field.

  • DateTime: DateTime “DateTime” selection via text field or “DateTimePicker”.

Info

All of these elements can be used as often as you want and in any possible order and combination.

Overview

All metadata elements follow the same XML structure. Each element starts with the following XML - element:

Code Block
<control></control>

This element can only have one attribute ("resetAfterRecord"), which resets the Metadata Field's value after each Recording (0“0”, means the values value stays as it is. Value “1” will reset the value):

Code Block
languagexml
<control resetAfterRecord="1"></control>

Within this <control-> element, you have to define the “name”, “label”, “currentValue” currentValue”, and “type”:

Code Block
<control resetAfterRecord="0">
        <name>quality</name>					#use this name to address the value of this element within the ExportXML 
        <label>Quality</label>					#this name will be used to tag the element within the just:in interface (inspector)
		<currentValue>Medium</currentValue>		#sets the default value for this element
        <type class="Selection">				#defines the control type (selection, text, checkbox, etc.)
            <item>Low</item>
            <item>Medium</item>
            <item>High</item>
        </type>
</control>

Selection Box

The “Selection Box” Element Box” element can be used , if the just:in linux operator should choose from a predefined set of options.:

Code Block
<control resetAfterRecord="0">
        <name>quality</name>
        <label>Quality</label>
        <currentValue>Medium</currentValue>
        <type class="Selection">
            <item>Low</item>
            <item>Medium</item>
            <item>High</item>
        </type>
</control>

Text Box

The “Text Box” Box” element can be used for any element, which should contain text only.:

Code Block
<control resetAfterRecord="0">
        <name>customText</name>
        <label>Custom Text</label>
        <currentValue>Insert your text here</currentValue>
        <type class="Text" default="Insert your text here"></type>
</control>

Checkbox

The “Checkbox” Checkbox” is for any elements, which that can only have two states.:

Code Block
<control resetAfterRecord="0">
        <name>special</name>
        <label>Special</label>
        <currentValue>0</currentValue>
        <type class="Checkbox">
        </type>
    </control>

Date

This element is for selecting a “Date”.lets you choose a “Date”:

Code Block
<control resetAfterRecord="0">
        <name>date</name>
        <label>Date</label>
        <currentValue></currentValue>
        <type class="Date" default=""/>
</control>

Time

This element can lets you choose a specific “Time”.Time”:

Code Block
<control resetAfterRecord="0">
        <name>time</name>
        <label>Time</label>
        <currentValue></currentValue>
        <type class="Time" default=""/>
</control>

DateTime

With this element, a specific “Date” and “Time” can be defined.

Code Block
<control resetAfterRecord="0">
        <name>datetime</name>
        <label>DateTime</label>
        <currentValue></currentValue>
        <type class="DateTime" default=""/>
</control>

Date/Time/DateTime Format

Changing the format of these metadata elements is very easy and straightforward as well. In order to make this as flexible as possible, we are using the default system settings for that. To change that, open the custom format settings for “Dates” and “Times”, which can be found here:

  • Open the macOS System Preferences and open the “Date & Time” Preferences panel

...

  • Open “Language & Region” settings (“Date & Time” tab)

...

  • Switch to the “Advanced” settings

...

  • Change “Dates” and/or “Times” Format settings here ("Full:")

...

StartUpXML Example

...

Info

Please note that the Date and Time Format changes within the System Preferences are only possible with macOS Monterey or with earlier macOS versions. Starting with macOS Ventura this is no longer possible. When using macOS Ventura or later, please consider using the following Terminal commands to adjust the Date and Time formats:

Date:

defaults write -g AppleICUDateFormatStrings -dict 4 "ddMMyyyy"

Time:

defaults write -g AppleICUTimeFormatStrings -dict 4 "HHmm"

Adjust the format part according to your needs and restart Just Control.

Please note that you cannot change the Date format within the “Language & Region” preference pane within the “System Settings” pane, as this will override the custom Date and Time settings applied above (macOS Ventura only).

...

StartUpXML Example

Please note that the “StartUpXML” file structuremust follow the rules mentioned above; otherwise, the Metadata Sets will not work correctly and can lead to unexpected behaviourresults.

Code Block
languagexml
<metadataSet>
    <name>Example</name>
    <extension>xml</extension>
    
    <control resetAfterRecord="0">
        <name>quality</name>
        <label>Quality</label>
        <currentValue>Medium</currentValue>
        <type class="Selection" default="2">
            <item>Low</item>
            <item>Medium</item>
            <item>High</item>
        </type>
    </control>
    <control resetAfterRecord="0">
        <name>customText</name>
        <label>Custom Text</label>
        <currentValue>Insert your text here</currentValue>
        <type class="Text" default="Insert your text here"></type>
    </control>
    <control resetAfterRecord="0">
        <name>Just_In_Custom_Date</name>
        <label>Custom Date</label>
        <currentValue>YYYY.MMM.dd</currentValue>
        <type class="Text" default="YYYY.MMM.dd"></type>
    </control>
    <control resetAfterRecord="0">
        <name>special</name>
        <label>Special</label>
        <currentValue>0</currentValue>
        <type class="Checkbox" default="0">
        </type>
    </control>
    <control resetAfterRecord="0">
        <name>date</name>
        <label>Date</label>
        <currentValue></currentValue>
        <type class="Date" default=""/>
    </control>
    <control resetAfterRecord="0">
        <name>time</name>
        <label>Time</label>
        <currentValue></currentValue>
        <type class="Time" default=""/>
    </control>
    <control resetAfterRecord="0">
        <name>datetime</name>
        <label>DateTime</label>
        <currentValue></currentValue>
        <type class="DateTime" default=""/>
    </control>
</metadataSet>

ExportXML Example

The ExportXML “ExportXML” file can have any possible structure. As mentioned above, the variables defined in the StartUpXML “StartUpXML” can be addressed like as shown below.

Code Block
languagexml
<?xml version="1.0" encoding="UTF-8" ?>

<file name="%Just_In_Clipname" path="%Just_In_Full_Clipname" duration="%Just_In_Capture_Duration" inpoint="%Just_In_Capture_Inpoint" outpoint="%Just_In_Capture_Outpoint" date="%Just_In_Custom_Date">
		
	<quality>%quality</quality>
	
	<text>%customText</text>
	
	<special>%special</special>
    
    <special>%date</special>
    
    <special>%time</special>
    
    <special>%datetime</special>
    
    <container>%Just_In_Container</container>
    
    <timecodeSource>%Just_In_Timecode_Source</timecodeSource>

    <framerate>%Just_In_Framerate</framerate>

    <aspectRatio>%Just_In_Aspect_Ratio</aspectRatio>
    
    <codec>%Just_In_Capture_Codec</codec>
    
    <audioChannels>%Just_In_Audio_Channels</audioChannels>
        
    <resolution>%Just_In_Capture_Resolution</resolution>
    
    <width>%Just_In_Capture_Width</width>
    
    <height>%Just_In_Capture_Height</height>
	
</file>

...