Warning signs can manifest themselves in many forms: one-on-one settings, group interaction, public behavior, letters, emails, blogs, websites, social networking sites, photos, phone calls, text messages, etc. The following list of warning signs is not intended to be fully comprehensive.

Privacy masking is a feature that makes it possible to mask out, i.e. cover areas in the picture that should not be visible to the viewers, such as the face of a person, logotypes and license plates. The masks will adapt their position and size when the cameras pan/tilt/zoom position changes to make sure that areas that have been masked remain that way.

At the same time, we ask that you recognize that all of us are susceptible to unconscious biases. Attending to warning signs is about focusing strictly on concerning behaviors and not allowing unexamined biases and prejudices to enhance our fears and inappropriately implicate an individual based on their race, ethnicity, gender, religion and personal background.

Please note that pixel coordinates for a corner that is outside the current camera view will have values that are negative or larger than the image´s resolution.

Add a privacy mask named mask1 to the center of the image. The width and height of the mask are set in percent of the image size.

getOverlayCapabilities returns the number of total overlay slots, the number of slots occupied per text overlay and the number of slots occupied per image overlay.

Overlay IDs may change after a reboot. This is because the overlay system always uses the lowest available number, starting from 1.

The following table lists error codes that can be returned from this method. General errors are listed in Error handling.

Disables all privacy masks. This is useful during an emergency when you want to make sure that nothing vital gets hidden behind a mask.

Dynamic text overlay can be inserted in the text overlay. Since dynamic text is saved in the RAM memory only is removed on boot.

This API will no longer receive updates. For a newer version on how to upload and manage images used for image overlays, see Overlay image API.

Danger sign wallpaper

Modifiers can be used to format file names, folders for uploaded images, notification messages, text in image overlays and similar. A modifier always starts with a % or # character, followed by another character.

Pixel coordinates for a corner that is outside the current camera view will have values that are negative or larger than the image´s resolution.

There currently exist two ways to create privacy masks. One is by using privacymask.cgi and the other by using param.cgi. Some functions, such as color and mosaic scale, can only be set using param.cgi, which means that some products will be using both.

Danger warningsigns

One new property, textOLColor is added for text overlays, possible values are "black", "white", "red", "transparent" and semiTransparent".

Please note that this method will disable all masks. If you wish to disable individual privacy masks you should use param.cgi.

The following table lists error codes that can be returned from this method. General errors are listed in Error handling.

Dangersignsand symbols

The Dynamic overlay API gives applications and users the ability to both get and set overlay configurations in the Axis cameras. Each overlay in the camera is identified by an ID which is returned upon creation. An overlay can be either text, image or special overlays that are provided by other applications, such as the Privacy mask API. It is also possible to remove overlays created by the API. The special overlays can not be configured from this API.

An overlay can contain several bitmap images to be adaptable to different resolutions. By calling the list command, the user receives a list showing all of the available pictures.

all_position is optional. If present, it will contain the values found in position, as well as any helper corners added by the service.

a. Success respons example. The response gives a list of overlays with all corresponding properties. Note that scale-to-resolution overlays are only listed as a single directory as described in Add image overlays for the add image overlay usecase. If the overlay is scaled to the resolution, then the scalable property should be set to true.

list all overlays created by the add CGIs and display both their IDs and other properties. If specified, properties for all overlays can be listed for a given camera or, if further specified, for a specific camera layer. The IDs may change for each overlay after a reboot. It is therefore recommended to check the current overlay ID with list before it is updated or removed.

The API consists of a CGI enabling a user to control the underlaying dynamic overlays. There is one CGI request that implements a number of methods and to which the responses are in the JSON format.

a) Successful response example. The response list all available images. For each image a path identifying the image and a flag indicating the scaleWithResolution status is provided.

All existing properties and values of the current text and image overlays from param.cgi will be supported with only changes as follows:

The following table lists error codes that can be returned form this method. General errors are listed in Error handling.

setText is used to update parameters for a certain text overlay. The user may specify more than one parameter at any time. Optional parameters that are not supplied will not be charged.

Danger sign drawing

The Dynamic overlay API replaces the previously used Image overlay and Text overlay API that were both using the param.cgi parameter.

addImage is used to create new image overlays. When creating an overlay using the CGI you may also specify properties at the same time.

For action=upload the POST method must be used; the file content is provided in the HTTP body. The image file should be uploaded using Multipart/Form-Data as defined in RFC 1867.

We encourage you to become familiar with violence prevention programs on campus and to utilize those resources when you feel it necessary. The most important component of violence prevention and threat assessment is the communication of observed behavior to the appropriate resources (Faculty & Staff, PostDocs, Students) so that intervention can occur before something happens.

Danger sign photos

Position array can contain up to Properties.PrivacyMask.MaxNbrOfCorners x/y pairs. If the privacy mask is not visible in the current camera position, an empty position array will be returned.

The following table lists general error that can occur for any CGI method. Errors that are specific for a method are listed under the API description for that method.

The implementation uses the same resources as param.cgi. It is possible to use dynamicoverlay.cgi to change overlays created with param.cgi and vice versa. However, using both dynamicoverlay.cgi and param.cgi for overlay handling may lead to unexpected behavior.

The Overlay API is used to access overlay functionality such as privacy masks, text overlay and image overlay. The API is divided into:

The text overlay is a text field that can be included in the top or bottom of the video image from an Axis product. The functionality can be used for showing static text, pan, tilt and zoom coordinates, preset positions, bit rate, etc. In addition to that it is also allowed to insert dynamic text, for example from an application. The dynamic text is contained in the RAM memory only and is removed on boot.

Position array may contain up to Properties.PrivacyMask.MaxNbrOfCorners x/y pairs. If the privacy mask is not visible in the current camera position, an empty position array will be returned.

By calling the list command a second time, the user receives information on all of the overlays, including the newly created overlay. In the description of the overlay is a variable called scalable that let the user know if the overlay is scale-to-resolution or not. Scale-to-resolution means that the image overlay re-scale based on the resolution of the video stream.

An overlay image is a static image superimposed over the video image. An overlay can for example be used to provide extra information, for example a logotype.

The shape of a privacy mask is defined by a list of corner coordinates that either forms a rectangle or a polygon. Which form that is supported is described by a property parameter.

The Overlay image API makes it possible for applications to upload and manage images used for image overlays and configure the default image used in stream profiles.

addText is used to create new text overlays. When creating an overlay using the CGI you may also specify properties at the same time.

It is possible to use modifiers starting with % in this dynamic text. Modifiers starting with # can however not be used.

The following table lists error codes that can be returned from this method. General errors are listed under Error handling.

Danger sign name

validateImageHeader will check if the image described by the parameters are supported, is of an acceptable file-size and that there are enough memory on the device. In cases where there are an invalid parameter, an error response is sent and the status code is set to reflect what the problem might be.

Overlay modifiers are markup strings that when present in overlay text strings are expanded according to their corresponding function.

Use image-%F-%H-%M-%S.jpg so timestamp uploaded video snapshots with the date, hour, minute and second the snapshot was taken.

The following table lists error codes that can be returned from this method. General errors are listed in Error handling.

Dynamic overlay is used to configure different sorts of overlays in the Axis cameras and improves on the previously used param.cgi-based API by also being able to:

Add a privacy mask named mask1 centered around 20% of the image width and 20% of the image height of the picture. Width and height are set in percent of the image size.

Use this example to add text overlays with transparent backgrounds, in this case one at the top left corner of the video that shows timestamps and another at the right bottom corner that shows the address and location of the camera.

The following table lists error codes that can be returned from this method. General errors are listed in Error handling.

zoom_visible is optional. If present, it will indicate whether the position polygon is visible due to the zoomlowlimit setting.

setImage is used to update parameters for a certain image overlay. The user may specify more than one parameter at one time, however optional parameters that are not supplied will not be changed.