documentation/manual/source/projector.rst
2023-01-19 17:55:40 +00:00

13 KiB

Projector Manager

The Projector Manager allows you to remotely control a network-connected projector that conforms to the Japan Business Machine and Information System Association (JBMIA) PJLink specification. Available in OpenLP v2.2.

Projector Configuration

The available projector options can be changed using the main settings menu by going to Settings -> Configure OpenLP -> Projectors tab. See configure_projectors.

Projector Manager

The Projector Manager is the interface to controlling your projector(s). It is located on the bottom-right corner of OpenLP just below the Theme Manager.

PROJECTOR_MANAGER

The icons on the Projector Manager tab will depend on projector entries as well as how many projectors are selected at once.

A list of possible projector icons are:

PROJECTOR_NEW New Projector:

Choosing this option will open the "Create New Projector" dialog so you can enter a new projector item.

PROJECTOR_EDIT Edit Projector:

When you have selected a projector item, this option will open the "Edit Projector" dialog so you can make changes to that projector item.

PROJECTOR_SOURCE Select Projector Input:

When you have selected a projector item and it is connected and power is ON, this option will give you a dialog that allows you to select the video source the projector will use.

PROJECTOR_DELETE Delete Projector:

When you have selected a projector item, this option will allow you to delete the projector item from the Projector manager list.

PROJECTOR_INFO Projector Information:

When you have selected a projector item and it is connected to the projector, this option will give you an information box with extra information about the projector.

PROJECTOR_CONNECT Connect to Projector:

When you have selected a projector item, this option will allow you to connect to the projector.

PROJECTOR_CONNECT_TILED Connect to Multiple Projectors:

When you have multiple projector items selected, this option will allow to to connect to multiple projectors at once.

PROJECTOR_DISCONNECT Disconnect from Projector:

When you have a projector item selected, this option will allow you to disconnect from the projector.

PROJECTOR_DISCONNECT_TILED Disconnect from Multiple Projectors:

When you have multiple projector items selected, this option will allow to disconnect from multiple projectors at once.

PROJECTOR_POWER_ON Power On Projector:

When you have selected a projector item and it is connected, this option will allow you to turn the projector to "Power ON".

PROJECTOR_POWER_ON_TILED Power On Multiple Projectors:

When you have selected multiple projector items and they are connected, this option will allow you to turn the projectors to "Power ON".

PROJECTOR_POWER_OFF Power Off Projector:

When you have selected a projector item and it is connected, this option will allow you to turn the projector to "Power STANDBY".

PROJECTOR_POWER_OFF_TILED Power Off Multiple Projectors:

When you have selected multiple projector items and they are connected, this option will allow you to turn the projectors to "Power STANDBY".

PROJECTOR_BLANK Blank Projector Screen:

When you have a projector item selected and it is powered ON, this option will allow you to blank the projector screen so no video is shown.

PROJECTOR_BLANK_TILED Blank All Projector Screens:

When you have multiple projector items selected and they are powered ON, this option will allow you to blank the projector screens so no video is shown.

PROJECTOR_SHOW Show Projector Screen:

When you have a projector item selected and it is powered ON, this option will allow you to unblank the projector screen so video is shown.

PROJECTOR_SHOW_TILED Show All Projector Screens:

When you have multiple projector items selected and they are powered ON, this option will allow you to unblank the projector screens so video is shown.

Adding a Projector

To add a new projector, click on the Add New Projector icon on the Projector Manager tab bar. You will be given an input dialog box like the below image.

PROJECTOR_ADD_NEW

The required information are "IP Address", "Port Number", and "Name" entries. The port number is already set with the default PJLink port.

The "PIN" entry is only needed if the projector you are connecting to has the PJLink PIN set. Be careful, since most projectors have a separate entry for the PJLink PIN, any other network PIN or password, as well as a separate entry for any HTML access name/password settings (if the projector has HTML webpage access). The PIN setting here is ONLY used if the projector has a "PJLink access code" or "PJLink PIN" setting.

For information on what the fields are, you can click on Help button for some information about what is expected for each field.

Once you are done entering the new information, click on Save to save the entry and add it to the projector manager list. If you decide to not add a new entry, click the Cancel button to close the dialog without saving.

Congratulations, you now have your first projector entry in the list and ready for control.

PROJECTOR_MANAGER_LIST

When you have multiple projector entries selected, the projector manager toolbar will change to the following:

PROJECTOR_ITEM_MULTIPLE_SELECTION

Once you select a projector, the icons will also change based on the status of the projector.

View Projector Information

After you have a projector item added and it's connected, you can view the current status of the projector by clicking on the View Projector Information icon. You will see a pop-up box that looks similar to the following: (NOTE: Example information only - the information you see will depend on the projector that you are connected to)

PROJECTOR_ITEM_VIEW

Projector Status Icons

The icons next to the projector entry in the projector manager list give you a quick visual status of the projector.

The icons you will see for the projector are:

PROJECTOR_ITEM_DISCONNECT Projector is disconnected

PROJECTOR_ITEM_CONNECT Attempting to connect to projector

PROJECTOR_NOT_CONNECTED_ERROR There was an error connecting to projector

PROJECTOR_ITEM_OFF The projector power is OFF (Standby)

PROJECTOR_ITEM_WARMUP The projector is warming up

PROJECTOR_ITEM_ON The projector is on

PROJECTOR_ITEM_COOLDOWN The projector is cooling down before power off (standby)

PROJECTOR_ITEM_ERROR The projector is reporting an error

Projector Menus

The projector menu items will vary depending on what the status is of the selected projector. The icons/options available are the same as described above in the icon description section.

Initial Menu

When you first enter a projector or when you first start OpenLP, you will select from the following menu items:

PROJECTOR_ITEM_NOT_CONNECTED_MENU

Projector Connected in Standby Mode

Once the projector has been connected, and if the projector is not powered on, you get the below menu list:

PROJECTOR_ITEM_CONNECTED_OFF

Projector Connected in Warmup Mode

Once the projector is in warming up, you will see the following menu:

PROJECTOR_ITEM_CONNECTED_WARMUP_MENU

Projector Connected and Power On

Once the projector is on, you will see the following menu:

PROJECTOR_ITEM_POWER_ON_MENU

Projector Connected and in Cooldown Mode

When the projector is cooling down, you will see the following menu:

PROJECTOR_ITEM_COOLDOWN_MENU

Video Source Options

The video source options allow you to tell the projector to change it's video source input, as well as allowing you to personalize what the video settings options.

Video Source Input Select Options

If you want to change the video source the projector uses, click on the Select Source option, then select from the pop-up window which video source you want to use. You can access the Select Source option from either the projector manager toolbar or from the right-click pop-up menu.

You have an option of setting two different styles for the video source window. The default option is all entries on one radio button dialog. The other option is to have the selections grouped by type. This option is available in the Settings -> Configure OpenLP -> Projectors tab under the "Source Select dialog interface" option.

NOTE: These images are examples only - what options you will have will vary depending on the projector you have. These images show the default PJLink text.

PROJECTOR_SOURCE_SELECT_TABBED

Video Source Input Edit Options

When you want to customize how the video source select text looks, click on the Edit Input Source icon in the right-click menu. This will bring up the source edit dialog box.

NOTE: These images are examples only - what options you will have will vary depending on the projector you have. These images show the default PJLink text.

PROJECTOR_SOURCE_EDIT_TABBED

Once you are satisfied, you can click on the OK button to save the changes, or click on the Cancel button to discard these changes and continue to use the previously saved user-defined text (or the PJLink defaults if you have no previously saved user-defined text).

If you don't like the changes, the Reset button will reset the text back to the previously saved text (or PJLink defaults if you have no previously saved user-defined text) and allow you to continue editing.

If you _really don't like the text, you can select the Discard button and remove all entries from the database. WARNING: This will delete _all of the user-defined entries for this projector in the database and return them to the PJLink defaults.