The majority of formats require the same two steps for visualization on a GXY view. To visualize GeospatialPDF data:

  1. Decode the data into an ILcdModel using an ILcdModelDecoder.

  2. Create an ILcdGXYLayer for the ILcdModel and add it to the ILcdGXYView.

//First create the model
ILcdModelDecoder decoder =
    new TLcdCompositeModelDecoder(TLcdServiceLoader.getInstance(ILcdModelDecoder.class));
ILcdModel model = decoder.decode("Data/GeospatialPDF/AZ_Bright Angel_314414_1962_62500_geo.pdf");

//Create a layer for the model with default styling
ILcdGXYLayer layer = createGXYGeospatialPDFLayer(model);
//Wrap the layer with an async layer wrapper to ensure
//that the view remains responsive while data is being painted
layer = ILcdGXYAsynchronousLayerWrapper.create(layer);

//Add the async layer to the GXY view (an ILcdGXYView)
 * The model decoder can return a single ILcdModel or an ILcdModelTreeNode,
 * depending on the data set.
 * This method can deal with both scenarios
static ILcdGXYLayer createGXYGeospatialPDFLayer(ILcdModel model) {
  //The model decoder returns a model tree node when the PDF contains multiple map frames
  //The node itself is just an empty container. We create an empty layer node for that container.
  //Then we loop over the child models (=the actual data), and create layers for those as well
  if (model instanceof ILcdModelContainer) {
    TLcdGXYLayerTreeNode node = new TLcdGXYLayerTreeNode(model);
    for (int i = 0; i < ((ILcdModelContainer) model).modelCount(); i++) {
      ILcdModel childModel = ((ILcdModelContainer) model).getModel(i);
      //Use recursion to create layers for the child models
    return node;
  } else if (TLcdGeospatialPDFModelDescriptor.TYPE_NAME.equals(model.getModelDescriptor().getTypeName())) {
    return TLcdGXYLayer.create(model);
  throw new IllegalArgumentException("Cannot create layer for model " + model);

This results in a GeospatialPDF layer with default styling. See Visualizing Raster Data for more information about visualizing and styling raster data.

This code snippet uses the TLcdCompositeModelDecoder, initialized with all model decoders available in the service registry.

The model decoder class that is actually responsible for decoding GeospatialPDF data is the TLcdGeospatialPDFModelDecoder.