Guided Image

Guided Image object is used to display Image with descriptions to Image's key points. This Object needs Guide Mark Objects to mark Image's key points. This type of Object its own Controls ribbon with Next/Previous buttons.

This Object can save and restore its last state, i.e. when you return to the Slide this Object will display the last displayed element.

Examples of object appearance in Edit mode (note Guide Marks on the Image):

The same Object in real Course looks different - Guide Marks are not visible, but arrow from Description Area points exactly to the one of the Guide Marks:

Object Parameters

On the Main tab you can select the Image, position and scaling and the list of Guide Mark objects, which will be managed. You can also select arrow color to make it contrast relative to the Image.

Image in the Object area is scaled according to selected Image scaling type - select appropriate depending on Image width and height proportions. Note that in some cases image clipping may occur.

• By height - Image height will be scaled to Object work area height, width will be scaled in the same ratio.
• By half height - Image height will be scaled to the half of Object work area height, width will be scaled in the same ratio.
• By width - Image width will be scaled to Object work area width, height will be scaled in the same ratio.
• By half width - Image width will be scaled to the half of Object work area width, height will be scaled in the same ratio.
• No scaling - Image will be displayed in its original size. Note that if Image width or height will exceed work area size then clipping may occur.

Guide mark ID - ID of corresponding Guide Mark Object. Description - full text that will be displayed in Description Area of the Object when corresponding Guide Mark is selected. This is Rich Text field - it can contain pictures, tables, links etc. Scroll bar will be added automatically when text size will exceed Description Area size. For each element you can define sound file with narration.

Display from the start checkbox allows displaying this Description selected from the start. In case no element is selected first element will be selected by default. In case more than one Mark is selected - first selected element will be active, others will be ignored.

On the Controls tab you can change display parameters for Controls ribbon and buttons or switch it off.

On the Description tab you can specify display parameters for Description block.

On the Background tab you can switch displaying of background block on and off and define its display parameters:

• Color scheme (one of predefined or custom),
• Border width,
• Gradient angle - from 0 (north direction) to 360 degrees clockwise,
• Corner radius in pixels,
• Inner padding.

On the Sound tab you can switch click and mouseover sounds on and off, or change it to custom sounds.

IMPORTANT! Sounds must be short and have no starting lag. Otherwise it may lead to undesirable delays in course playing.

Object Events

Object is capable generating events with regards to the user's actions and interpretation of the actions by the object. When combined with actions events can be employed for building up intellectual behavior models for other objects depending on the current state of the Object. Events are available using CourseLab built-in events manipulation mechanism.

Event	Triggered Upon
on Display Item	After displaying each element
on Display First Item	After displaying first element
on Display Last Item	After displaying last element
on All Items Displayed	After displaying last unvisited element. If the Object is configured to restore its state then this event will be fired only once.

Object Methods

The following Methods can be used when working with this Object.

Method	Result
DISPLAY NEXT ITEM	Displays next element (if exists)
DISPLAY PREV ITEM	Displays previous element (if exists)
SHOW	Displays the element by number (if exists) The parameter is element number (starting from 1).

Object Specific Properties

Along with common object properties, this object has some specific properties, that can be used in actions and in text substitutions (OBJ_ID below means current object ID):

Property	Returns	Syntax
item	Number of current element (starting from 1)	$OBJ_ID.item
allVisited	Returns "1" if all elements are visited, "0" - otherwise.	$OBJ_ID.allVisited