Class MapFishPrintV2Manager

Hierarchy

  • BaseMapFishPrintManager
    • MapFishPrintV2Manager

Constructors

constructor

Properties

_dpi? _dpis _extentFeature? _initiated _layout? _layouts _outputFormat? _outputFormats _printMapSize? _scale? _scales capabilities? credentialsMode customParams? customPrintScales? events extentLayer? headers? layerFilter legendFilter map maskColor method serializers timeout transformOpts? url? CUSTOM_PRINT_SERIALIZER_OPTS_KEY EXTENT_LAYER_NAME INFO_JSON_ENDPOINT TRANSFORM_INTERACTION_NAME

Methods

calculatePrintExtent calculateRotation dispatch download filterPrintableLayer filterPrintableLegend getClosestScaleToFitExtentFeature getClosestScaleToFitMap getCustomParam getCustomParams getDpi getDpis getExtentLayer getLayout getLayouts getOutputFormat getOutputFormats getPrintExtentSize getPrintMapSize getPrintPayload getScale getScales init initManager initPrintExtentFeature initPrintExtentLayer initTransformInteraction isInitiated loadCapabilities on onExtentLayerPostRender onExtentLayerPreRender onTransformScaling print resetRotation serializeLayer serializeLegend setCustomParam setCustomParams setDpi setLayout setLegendFilter setOutputFormat setPrintMapSize setRotation setScale shutdownManager un updatePrintExtent validateResponse

Constructors

constructor

Properties

Protected Optional_dpi

_dpi?: number

The currently selected dpi.

Protected_dpis

_dpis: number[] = []

The supported DPIs by the print service.

Protected Optional_extentFeature

_extentFeature?: Feature<Polygon>

Feature representing the page extent.

Protected_initiated

_initiated: boolean = false

Whether this manger has been initiated or not.

Protected Optional_layout

_layout?: Layout

The currently selected layout.

Protected_layouts

_layouts: Layout[] = []

The supported layouts by the print service.

Protected Optional_outputFormat

_outputFormat?: string

The currently selected output format.

Protected_outputFormats

_outputFormats: string[] = []

The supported output formats by the print service.

Protected Optional_printMapSize

_printMapSize?: PrintMapSize

The currently set map size defined with its width and height.

Protected Optional_scale

_scale?: number

The currently selected scale.

Protected_scales

_scales: number[] = []

The supported scales by the print service.

Protected Optionalcapabilities

capabilities?: any

ProtectedcredentialsMode

credentialsMode: RequestCredentials

Protected OptionalcustomParams

customParams?: any

Protected OptionalcustomPrintScales

customPrintScales?: number[]

Protectedevents

events: any = {}

The registered events.

Protected OptionalextentLayer

extentLayer?: VectorLayer<Feature<Geometry>>

Protected Optionalheaders

headers?: {
    [key: string]: string;
}

ProtectedlayerFilter

layerFilter: ((layer: Layer<Source, LayerRenderer<any>>) => boolean)

ProtectedlegendFilter

legendFilter: ((layer: Layer<Source, LayerRenderer<any>>) => boolean)

Protectedmap

map: Map

ProtectedmaskColor

maskColor: string

Protectedmethod

method: "GET" | "POST"

Protectedserializers

serializers: BaseSerializer[] = []

Protectedtimeout

timeout: number

Protected OptionaltransformOpts

transformOpts?: OlInteractionTransformOpts

Protected Optionalurl

url?: string

StaticCUSTOM_PRINT_SERIALIZER_OPTS_KEY

CUSTOM_PRINT_SERIALIZER_OPTS_KEY: string = 'customPrintSerializerOpts'

The key in the layer properties to lookup for custom serializer options.

StaticEXTENT_LAYER_NAME

EXTENT_LAYER_NAME: string = 'PrintManager Vector Layer'

The name of the vector layer configured and created by the print manager.

StaticINFO_JSON_ENDPOINT

INFO_JSON_ENDPOINT: string = 'info.json'

The capabilities endpoint of the print service.

StaticTRANSFORM_INTERACTION_NAME

TRANSFORM_INTERACTION_NAME: string = 'PrintManager Transform Interaction'

The name of the transform interaction configured and created by the print manager.

Methods

ProtectedcalculatePrintExtent

  • calculatePrintExtent(scale?): undefined | number[]

  • Calculates the extent based on a scale.

    Parameters

    • Optionalscale: number

      The scale to calculate the extent for. If not given, the current scale of the provider will be used.

    Returns undefined | number[]

    The extent.

ProtectedcalculateRotation

  • calculateRotation(): undefined | number

  • Calculates the current rotation of the print extent feature.

    Returns undefined | number

dispatch

  • dispatch(name, data): void

  • Dispatches the given event with the provided data.

    Parameters

    • name: string

      The name of the event to dispatch.

    • data: any

      The data to apply to the event callback.

    Returns void

Protecteddownload

  • download(url): void

  • Opens the given URL in a new browser tab to download the given response (if header are set correctly).

    Parameters

    • url: string

      The url to open.

    Returns void

ProtectedfilterPrintableLayer

  • filterPrintableLayer(layer): boolean

  • Checks if a given layer should be printed.

    Parameters

    • layer: Layer<Source, LayerRenderer<any>>

      The layer to check.

    Returns boolean

    Whether the layer should be printed or not.

ProtectedfilterPrintableLegend

  • filterPrintableLegend(layer): boolean

  • Checks if the legend of a given legend should be printed.

    Parameters

    • layer: Layer<Source, LayerRenderer<any>>

      The layer to check.

    Returns boolean

    Whether the legend of the layer should be printed or not.

ProtectedgetClosestScaleToFitExtentFeature

  • getClosestScaleToFitExtentFeature(): undefined | number

  • Returns the closest scale to current print feature's extent.

    Returns undefined | number

getClosestScaleToFitMap

  • getClosestScaleToFitMap(): number

  • Returns the closest scale to fit the print feature's extent into the current extent of the map.

    Returns number

getCustomParam

  • getCustomParam(key): any

  • Returns an individual custom param.

    Parameters

    • key: string

      The custom param to get.

    Returns any

    The custom param

getCustomParams

getDpi

  • getDpi(): undefined | number

  • Returns the currently selected dpi.

    Returns undefined | number

    The currently selected dpi.

getDpis

getExtentLayer

  • getExtentLayer(): undefined | VectorLayer<Feature<Geometry>>

  • Returns the extent layer.

    Returns undefined | VectorLayer<Feature<Geometry>>

    The extent layer.

getLayout

  • getLayout(): undefined | Layout

  • Returns the currently selected layout.

    Returns undefined | Layout

    The currently selected layout.

getLayouts

  • getLayouts(): Layout[]

  • Returns all supported layouts.

    Returns Layout[]

    The supported layouts.

getOutputFormat

  • getOutputFormat(): undefined | string

  • Returns the currently selected output format.

    Returns undefined | string

    The currently selected output format.

getOutputFormats

  • getOutputFormats(): string[]

  • Returns all supported output formats.

    Returns string[]

    The supported output formats.

ProtectedgetPrintExtentSize

  • getPrintExtentSize(printMapSize, printScale): PrintMapSize

  • Computes size of print extent in pixel depending on dimensions of print map and print scale.

    Parameters

    • printMapSize: PrintMapSize

      Print map size containing its width and height.

    • printScale: number

      Print scale.

    Returns PrintMapSize

    Print extent size.

getPrintMapSize

  • getPrintMapSize(): undefined | PrintMapSize

  • Returns print map size for chosen layout.

    Returns undefined | PrintMapSize

    The map size.

ProtectedgetPrintPayload

getScale

  • getScale(): undefined | number

  • Returns the currently selected scale.

    Returns undefined | number

    The currently selected scale.

getScales

init

ProtectedinitManager

  • initManager(capabilities): void

  • Initializes the manager instance. Typically called by subclasses via init().

    Parameters

    • capabilities: any

      The capabilities to set.

    Returns void

ProtectedinitPrintExtentFeature

  • initPrintExtentFeature(): undefined | Feature<Polygon>

  • Initializes the print extent feature.

    Returns undefined | Feature<Polygon>

    The extent feature.

ProtectedinitPrintExtentLayer

ProtectedinitTransformInteraction

  • initTransformInteraction(): void

  • Initializes the transform interaction.

    Returns void

isInitiated

  • isInitiated(): boolean

  • Whether this manager has been initiated or not.

    Returns boolean

    Whether this manager has been initiated or not.

ProtectedloadCapabilities

on

  • on(name, callback): void

  • Registers an event.

    Parameters

    • name: string

      The name of the event to register.

    • callback: Function

      The callback function to register.

    Returns void

ProtectedonExtentLayerPostRender

  • onExtentLayerPostRender(olEvt): void

  • Called on the extentLayer's postrender event.

    Parameters

    • olEvt: RenderEvent

      The ol render event.

    Returns void

ProtectedonExtentLayerPreRender

  • onExtentLayerPreRender(olEvt): void

  • Called on the extentLayer's prerender event.

    Parameters

    • olEvt: RenderEvent

      The ol render event.

    Returns void

ProtectedonTransformScaling

  • onTransformScaling(): void

  • Called on translate interaction's scaling event.

    Returns void

print

  • print(forceDownload?): Promise<undefined | string>

  • Calls the print servlet to create a output file in the requested format and forces a download of the created output.

    Note: The manager has to been initialized prior this method's usage.

    Parameters

    • OptionalforceDownload: boolean

      Whether to force a direct download of the print result or to return the download url.

    Returns Promise<undefined | string>

    If forceDownload is set to false, the download url of the print result will be returned in a Promise.

resetRotation

ProtectedserializeLayer

  • serializeLayer(layer): any

  • Serializes/encodes the given layer.

    Parameters

    • layer: Layer<Source, LayerRenderer<any>>

      The layer to serialize/encode.

    Returns any

    The serialized/encoded layer.

ProtectedserializeLegend

  • serializeLegend(layer): any

  • Serializes/encodes the legend payload for the given layer.

    Parameters

    • layer: Layer<Source, LayerRenderer<any>>

      The layer to serialize/encode the legend for.

    Returns any

    The serialized/encoded legend.

setCustomParam

  • setCustomParam(key, value): void

  • Sets an individual custom param.

    Parameters

    • key: string

      The key of the param.

    • value: any

      The value of the param.

    Returns void

setCustomParams

  • setCustomParams(params): void

  • Sets the custom params.

    Parameters

    • params: any

      The params to set.

    Returns void

setDpi

  • setDpi(value): void

  • Sets the dpi to use.

    Parameters

    • value: number

      The value of the dpi to use.

    Returns void

setLayout

  • setLayout(name): void

  • Sets the layout to use. Updates the print extent accordingly.

    Parameters

    • name: string

      The name of the layout to use.

    Returns void

setLegendFilter

  • setLegendFilter(filterFn): void

  • Setter for legend filter

    Parameters

    • filterFn: ((layer: Layer<Source, LayerRenderer<any>>) => boolean)

      The new legend filter function

        • (layer): boolean

        • Parameters

          • layer: Layer<Source, LayerRenderer<any>>

          Returns boolean

    Returns void

setOutputFormat

  • setOutputFormat(name): void

  • Sets the output format to use.

    Parameters

    • name: string

      The name of the output format to use.

    Returns void

setPrintMapSize

  • setPrintMapSize(printMapSize): void

  • Sets the map size to use while printing.

    Parameters

    • printMapSize: PrintMapSize

      The object containing width and height of printed map.

    Returns void

setRotation

  • setRotation(rotation): void

  • Rotates the print extent by the amount of the given rotation.

    Parameters

    • rotation: number

      The amount to rotate.

    Returns void

setScale

  • setScale(value): void

  • Sets the scale to use. Updates the print extent accordingly.

    Parameters

    • value: number

      The value of the scale to use.

    Returns void

shutdownManager

un

  • un(name, callback): void

  • Unregisters an event.

    Parameters

    • name: string

      The name of the event to unregister.

    • callback: Function

      The callback function to unregister.

    Returns void

updatePrintExtent

  • updatePrintExtent(): void

  • Updates the geometry of the print extent feature to match the current scale.

    Returns void

ProtectedvalidateResponse

  • validateResponse(response): void

  • Validates the given HTTP fetch response.

    Parameters

    • response: Response

      The response to validate.

    Returns void

Settings

Member Visibility

On This Page

Constructors
Properties
Methods