@arcgis/core 5.0.0-next.70 → 5.0.0-next.72

package/layers/orientedImagery/transformations/types.d.ts

@@ -3,12 +3,25 @@ import type ElevationSampler from "../../support/ElevationSampler.js";
 import type { AffineTransformations, PrincipalOffsetPoint, RadialDistortionCoefficients, TangentialDistortionCoefficients } from "../types.js";
 import type { ConstantElevation } from "../core/ElevationSourceDefinitions.js";
 
+/** @since 5.0 */
 export interface WorldToImageRequiredProperties {
-  /** A fixed length array of 6 numbers corresponding to the camera affine values A0, A1, A2, B0, B1, B2. The coefficient of the affine transformation establishes a relationship between the sensor space and image space. The direction is from ground to image. A0, A1, and A2 represent the translation in x direction, while B0, B1, and B2 represent the translation in y direction. Please refer to the [Oriented Imagery table](https://pro.arcgis.com/en/pro-app/latest/help/data/imagery/oriented-imagery-table.htm) for more information on the afffine values. */
+  /**
+   * A fixed length array of 6 numbers corresponding to the camera affine values A0, A1, A2, B0, B1, B2. The coefficient of the affine transformation establishes a relationship between the sensor space and image space. The direction is from ground to image. A0, A1, and A2 represent the translation in x direction, while B0, B1, and B2 represent the translation in y direction. Please refer to the [Oriented Imagery table](https://pro.arcgis.com/en/pro-app/latest/help/data/imagery/oriented-imagery-table.htm) for more information on the afffine values.
+   *
+   * @since 5.0
+   */
   affineTransformations: AffineTransformations;
-  /** A Point representing the camera location in world coordinates where the image was captured. */
+  /**
+   * A Point representing the camera location in world coordinates where the image was captured.
+   *
+   * @since 5.0
+   */
   cameraLocation: Point;
-  /** The row-wise sorted rotation matrix that defines the transformation from image space to map space, specified as an array of nine floating-point values. */
+  /**
+   * The row-wise sorted rotation matrix that defines the transformation from image space to map space, specified as an array of nine floating-point values.
+   *
+   * @since 5.0
+   */
   rotationMatrix: [
       number,
       number,
@@ -22,77 +35,160 @@ export interface WorldToImageRequiredProperties {
   ];
 }
 
+/** @since 5.0 */
 export interface WorldToImageWithFOVAndImageSize extends WorldToImageRequiredProperties {
-  /** The camera's field-of-view in a horizontal direction. The unit is degrees. The valid values range from 0 through 360. */
+  /**
+   * The camera's field-of-view in a horizontal direction. The unit is degrees. The valid values range from 0 through 360.
+   *
+   * @since 5.0
+   */
   horizontalFieldOfView: number;
-  /** Height of the image used for world to image transformation, in pixels. This parameter is used if the focal length is not provided. */
+  /**
+   * Height of the image used for world to image transformation, in pixels. This parameter is used if the focal length is not provided.
+   *
+   * @since 5.0
+   */
   imageHeight: number;
-  /** image used for world to image transformation, in pixels. This parameter is used if the focal length is not provided. */
+  /**
+   * image used for world to image transformation, in pixels. This parameter is used if the focal length is not provided.
+   *
+   * @since 5.0
+   */
   imageWidth: number;
-  /** The camera's field-of-view in the vertical direction. The unit is degrees. The valid values range from 0 through 180. */
+  /**
+   * The camera's field-of-view in the vertical direction. The unit is degrees. The valid values range from 0 through 180.
+   *
+   * @since 5.0
+   */
   verticalFieldOfView: number;
 }
 
+/** @since 5.0 */
 export interface WorldToImageWithFocalLength extends WorldToImageRequiredProperties {
-  /** The focal length of the camera lens. The unit can be microns, millimeters, or pixels. This parameter is used if ImageWidth and ImageHeight are not provided. */
+  /**
+   * The focal length of the camera lens. The unit can be microns, millimeters, or pixels. This parameter is used if ImageWidth and ImageHeight are not provided.
+   *
+   * @since 5.0
+   */
   focalLength: number;
 }
 
+/** @since 5.0 */
 export interface WorldToImageOptionalProperties {
-  /** A fixed length array of 2 numbers specifying the x-coordinate and  y-coordinate of the principal point of the autocollimation. The units must be the same as the unit used for FocalLength. The default value is [0,0]. This is an optional parameter. */
+  /**
+   * A fixed length array of 2 numbers specifying the x-coordinate and  y-coordinate of the principal point of the autocollimation. The units must be the same as the unit used for FocalLength. The default value is [0,0]. This is an optional parameter.
+   *
+   * @since 5.0
+   */
   principalOffsetPoint?: PrincipalOffsetPoint;
-  /** The radial distortion is specified as an array of three numbers, indicating [K1,K2,K3] coefficient values. The coupling unit is the same as the unit specified for FocalLength. The default value is [0,0,0]. This is an optional parameter. */
+  /**
+   * The radial distortion is specified as an array of three numbers, indicating [K1,K2,K3] coefficient values. The coupling unit is the same as the unit specified for FocalLength. The default value is [0,0,0]. This is an optional parameter.
+   *
+   * @since 5.0
+   */
   radialDistortionCoefficients?: RadialDistortionCoefficients;
-  /** The tangential distortion is specified as  an array of three numbers, indicating [P1,P2] coefficient values. The coupling unit is the same as the unit used for FocalLength. The default value is [0,0]. This is an optional parameter. */
+  /**
+   * The tangential distortion is specified as  an array of three numbers, indicating [P1,P2] coefficient values. The coupling unit is the same as the unit used for FocalLength. The default value is [0,0]. This is an optional parameter.
+   *
+   * @since 5.0
+   */
   tangentialDistortionCoefficients?: TangentialDistortionCoefficients;
 }
 
 /**
  * Represents the properties required for transforming world coordinates to image coordinates.
  * For more information on the properties, please refer to the [Oriented Imagery table](https://pro.arcgis.com/en/pro-app/latest/help/data/imagery/oriented-imagery-table.htm).
+ *
+ * @since 5.0
  */
 export type WorldToImageProperties = WorldToImageOptionalProperties
   & (WorldToImageWithFocalLength | WorldToImageWithFOVAndImageSize);
 
+/** @since 5.0 */
 export interface ImageToWorldRequiredProperties extends WorldToImageRequiredProperties {
-  /** The height of the ground at the camera's location (specified by cameraLocation), determined by subtracting the camera's height from the absolute z-coordinate of the location. This value can be adjusted as needed. The elevation value should have the same units as that of the cameraLocation's patial reference system (SRS). */
+  /**
+   * The height of the ground at the camera's location (specified by cameraLocation), determined by subtracting the camera's height from the absolute z-coordinate of the location. This value can be adjusted as needed. The elevation value should have the same units as that of the cameraLocation's patial reference system (SRS).
+   *
+   * @since 5.0
+   */
   averageElevation: number;
   /**
    * The camera orientation of the second rotation around the x-axis of the camera. The value is in degrees. The direction of measurement for heading is in positive counterclockwise direction.
    * The CameraPitch is zero degrees when the camera is facing straight down to the ground. The valid range of CameraPitch values is from 0 through 180 degrees. CameraPitch is 180 degrees for a camera facing straight up, and 90 degrees for a camera facing horizontally.
+   *
+   * @since 5.0
    */
   cameraPitch: number;
-  /** The camera orientation of the final rotation around the z-axis of the camera in the positive clockwise direction. The value is in degrees. Valid values range from -90 to 90. */
+  /**
+   * The camera orientation of the final rotation around the z-axis of the camera in the positive clockwise direction. The value is in degrees. Valid values range from -90 to 90.
+   *
+   * @since 5.0
+   */
   cameraRoll: number;
-  /** The farthest usable distance of the imagery from the camera position. This value determines the far plane of the visible frustum. The intersection of the frustum far plane with the ground defines the footprint, which is used to determine whether an image is returned when you click the map. The unit is meters. Values must be greater than zero. */
+  /**
+   * The farthest usable distance of the imagery from the camera position. This value determines the far plane of the visible frustum. The intersection of the frustum far plane with the ground defines the footprint, which is used to determine whether an image is returned when you click the map. The unit is meters. Values must be greater than zero.
+   *
+   * @since 5.0
+   */
   farDistance: number;
-  /** The camera's field-of-view in a horizontal direction. The unit is degrees. The valid values range from 0 through 360. */
+  /**
+   * The camera's field-of-view in a horizontal direction. The unit is degrees. The valid values range from 0 through 360.
+   *
+   * @since 5.0
+   */
   horizontalFieldOfView: number;
-  /** The camera's field-of-view in the vertical direction. The unit is degrees. The valid values range from 0 through 180. */
+  /**
+   * The camera's field-of-view in the vertical direction. The unit is degrees. The valid values range from 0 through 180.
+   *
+   * @since 5.0
+   */
   verticalFieldOfView: number;
 }
 
 /**
  * Represents the properties required for transforming image coordinates to world coordinates.
  * For more information on the properties, please refer to the [Oriented Imagery table](https://pro.arcgis.com/en/pro-app/latest/help/data/imagery/oriented-imagery-table.htm).
+ *
+ * @since 5.0
  */
 export type ImageToWorldProperties = ImageToWorldRequiredProperties
   & WorldToImageOptionalProperties
   & (WorldToImageWithFocalLength | WorldToImageWithFOVAndImageSize);
 
-/** Represents the properties required for updating the elevation of the output point. Users can either provide values from an elevationSampler or constantElevation. */
+/**
+ * Represents the properties required for updating the elevation of the output point. Users can either provide values from an elevationSampler or constantElevation.
+ *
+ * @since 5.0
+ */
 export type UpdateElevationProperties = UpdateElevationWithConstant | UpdateElevationWithSampler;
 
-/** Represents the properties required for updating the elevation of the output point with a constant value. */
+/**
+ * Represents the properties required for updating the elevation of the output point with a constant value.
+ *
+ * @since 5.0
+ */
 export interface UpdateElevationWithConstant {
-  /** An elevation source. */
+  /**
+   * An elevation source.
+   *
+   * @since 5.0
+   */
   elevationSource: UpdateElevationPropsWithConstantElevationSource;
 }
 
+/** @since 5.0 */
 export type UpdateElevationPropsWithConstantElevationSource = Pick<ConstantElevation, "constantElevation">;
 
-/** Represents the properties required for updating the elevation of the output point with an elevation sampler. */
+/**
+ * Represents the properties required for updating the elevation of the output point with an elevation sampler.
+ *
+ * @since 5.0
+ */
 export interface UpdateElevationWithSampler {
-  /** A cache of elevation values created from an elevation service used for synchronously querying elevation information for geometries. For more information on creating an elevation sampler, please refer [ElevationSampler](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-ElevationSampler.html). The elevation value should have the same units as that of the cameraLocation's spatial reference system (SRS). */
+  /**
+   * A cache of elevation values created from an elevation service used for synchronously querying elevation information for geometries. For more information on creating an elevation sampler, please refer [ElevationSampler](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-support-ElevationSampler.html). The elevation value should have the same units as that of the cameraLocation's spatial reference system (SRS).
+   *
+   * @since 5.0
+   */
   elevationSample: ElevationSampler;
 }

package/layers/orientedImagery/types.d.ts

@@ -1,7 +1,9 @@
 import type { TimeUnit } from "../../core/units.js";
 
+/** @since 5.0 */
 export type OrientedImageryType = "horizontal" | "nadir" | "oblique" | "360" | "inspection" | "terrestrial-frame-video" | "aerial-frame-video" | "terrestrial-360-video" | "aerial-360-video";
 
+/** @since 5.0 */
 export type Accuracy = [
     number,
     number,
@@ -13,6 +15,7 @@ export type Accuracy = [
     number
 ];
 
+/** @since 5.0 */
 export type AffineTransformations = [
     number,
     number,
@@ -22,36 +25,64 @@ export type AffineTransformations = [
     number
 ];
 
+/** @since 5.0 */
 export type PrincipalOffsetPoint = [
     number,
     number
 ];
 
+/** @since 5.0 */
 export type RadialDistortionCoefficients = [
     number,
     number,
     number
 ];
 
+/** @since 5.0 */
 export type TangentialDistortionCoefficients = [
     number,
     number
 ];
 
-/** The elevation source. */
+/**
+ * The elevation source.
+ *
+ * @since 5.0
+ */
 export interface ElevationSource {
-  /** The level of details (LODs) of the elevation source. */
+  /**
+   * The level of details (LODs) of the elevation source.
+   *
+   * @since 5.0
+   */
   lod?: number | null;
-  /** The raster function used in the elevation source. */
+  /**
+   * The raster function used in the elevation source.
+   *
+   * @since 5.0
+   */
   rasterFunction?: string | null;
-  /** The url of the elevation source. */
+  /**
+   * The url of the elevation source.
+   *
+   * @since 5.0
+   */
   url: string;
 }
 
-/** The unit of constant elevation value measured in meters. */
+/**
+ * The unit of constant elevation value measured in meters.
+ *
+ * @since 5.0
+ */
 export interface ConstantElevation {
-  /** The constant associated with the elevation source. */
+  /**
+   * The constant associated with the elevation source.
+   *
+   * @since 5.0
+   */
   constantElevation: number;
 }
 
+/** @since 5.0 */
 export type TimeIntervalUnit = Extract<TimeUnit, "days" | "hours" | "minutes" | "months" | "weeks" | "years">;

package/layers/pointCloudFilters/typeUtils.d.ts

@@ -2,4 +2,5 @@ import type PointCloudBitfieldFilter from "./PointCloudBitfieldFilter.js";
 import type PointCloudReturnFilter from "./PointCloudReturnFilter.js";
 import type PointCloudValueFilter from "./PointCloudValueFilter.js";
 
+/** @since 5.0 */
 export type PointCloudFilterTypes = PointCloudValueFilter | PointCloudBitfieldFilter | PointCloudReturnFilter;

package/layers/raster/datasets/TIFFRaster.js

@@ -2,4 +2,4 @@
 All material copyright Esri, All Rights Reserved, unless otherwise specified.
 See https://js.arcgis.com/5.0/esri/copyright.txt for details.
 */
-import{__decorate as e}from"tslib";import t from"../../../core/Error.js";import"../../../core/has.js";import i from"../../../core/Logger.js";import{property as r,subclass as s}from"../../../core/accessorSupport/decorators.js";import a from"../../../geometry/Extent.js";import n from"../../../geometry/Point.js";import o from"../../../geometry/SpatialReference.js";import f from"./BaseRaster.js";import l from"./DBFParser.js";import{parsePAMInfo as u,parseSpatialReference as c}from"./pamParser.js";import{parseSignature as h,getPyramidIFDs as p,getMaskIFDs as d,parseIFD as m,parseFieldValues as y,isBSQConfig as g,getImageInfo as x}from"../formats/TiffDecoder.js";import{tiffTags as w,geoKeys as I}from"../formats/tiffTag.js";import{estimateStatisticsFromHistograms as T}from"../functions/stretchUtils.js";import R from"../transforms/PolynomialTransform.js";import _ from"../../support/RasterInfo.js";import O from"../../support/RasterStorageInfo.js";import F from"../../../rest/support/FeatureSet.js";const S=(e,t)=>e.get(t)?.values,b=(e,t)=>e.get(t)?.values?.[0];let E=class extends f{constructor(){super(...arguments),this._files=null,this._headerInfo=null,this._bufferSize=1048576,this._chunkSize=10485760,this.datasetFormat="TIFF"}async fetchRawTile(e,t,i,r={}){if(!this._headerInfo?.isSupported||this.isBlockOutside(e,t,i))return null;const s=await this._fetchRawTiffTile(e,t,i,!1,r);if(null!=s&&this._headerInfo.hasMaskBand){const a=await this._fetchRawTiffTile(e,t,i,!0,r);null!=a&&a.pixels[0]instanceof Uint8Array&&(s.mask=a.pixels[0])}return s}async _open(e){const r=e?e.signal:null,{data:s}=await this.request(this.url,{range:{from:0,to:this._bufferSize},responseType:"array-buffer",signal:r});if(!s)throw new t("tiffraster:open","failed to open url "+this.url);this.datasetName=this.url.slice(this.url.lastIndexOf("/")+1,this.url.lastIndexOf("."));const{littleEndian:a,firstIFDPos:n,isBigTiff:o}=h(s),f=[],l={fileChunk:s,posIFD:n,fileOffset:0};await this._readIFDs(f,l,a,o?8:4,r);const{imageInfo:u,rasterInfo:c}=k(f),m=p(f),y=d(f);if(this._headerInfo={littleEndian:a,isBigTiff:o,ifds:f,pyramidIFDs:m,maskIFDs:y,...u},this._set("rasterInfo",c),!u.isSupported)throw new t("tiffraster:open","this tiff is not supported: "+u.message);if(!u.tileWidth)throw new t("tiffraster:open","none-tiled tiff is not optimized for access, convert to COG and retry.");c.isPseudoSpatialReference&&i.getLogger(this).warn("The spatial reference for this tiff is unsupported. Only EPSG spatial reference codes and Esri WKTs are supported.");const g=f[0].get("PREDICTOR")?.values?.[0],x=f[0].get("SAMPLEFORMAT")?.values?.[0];if(3===x&&2===g)throw new t("tiffraster:open","unsupported horizontal difference encoding. Predictor=3 is supported for floating point data");const{skipMapInfo:w,skipExtensions:I=[]}=this.ioConfig;if(!I.includes("aux.xml")&&!w){const t=await this._fetchAuxiliaryMetaData(e);null!=t&&v(t,c)}I.includes("vat.dbf")||1!==c.bandCount||"u8"!==c.pixelType||w||(c.attributeTable=await this._fetchAuxiliaryTable(e),null!=c.attributeTable&&(c.keyProperties.DataType="thematic")),w&&this.updateImageSpaceRasterInfo(c),this.updateTileInfo()}async _validateOrFetchHeaderBuffer(e,t){let{fileChunk:i,fileOffset:r,posIFD:s}=e;if(s+8>=i.byteLength||s<0){r=s+r;i=(await this.request(this.url,{range:{from:r,to:r+this._bufferSize},responseType:"array-buffer",signal:t})).data,s=0}return{fileChunk:i,fileOffset:r,posIFD:s}}async _readIFDs(e,i,r,s=4,a){if(!i.posIFD)return null;i=await this._validateOrFetchHeaderBuffer(i,a);const n=await this._readIFD(i,r,w,s,a);if(!n?.ifd)throw new t("tiffraster:open","cannot parse tiff header. failed to open url "+this.url);if(e.push(n.ifd),!n.nextIFD)return null;i.posIFD=n.nextIFD-i.fileOffset,await this._readIFDs(e,i,r,s,a)}async _readIFD(e,t,i=w,r=4,s){let{fileChunk:a,posIFD:n,fileOffset:o}=e;if(!e.fileChunk)return null;const f=m(a,t,n,o,i,r);if(f.success){const e=[];if(f.ifd?.forEach(t=>{t.values||e.push(t)}),e.length>0&&await this._fillOffsets(e,t,f.nextIFD,s),f.ifd?.has("GEOKEYDIRECTORY")){const e=f.ifd.get("GEOKEYDIRECTORY"),i=e?.values;if(i&&i.length>4){const r=i[0]+"."+i[1]+"."+i[2];n=e.valueOffset+6-o;const f=await this._validateOrFetchHeaderBuffer({fileChunk:a,posIFD:n,fileOffset:o},s),l=await this._readIFD(f,t,I,2,s);e.data=l?.ifd,e.data&&e.data.set("GEOTIFFVersion",{id:0,type:2,valueCount:1,valueOffset:null,values:[r]})}}return f}if(f.requiredBufferSize){return a=(await this.request(this.url,{range:{from:o,to:o+n+f.requiredBufferSize+8},responseType:"array-buffer",signal:s})).data,a.byteLength<n+f.requiredBufferSize?null:(e.fileChunk=a,e.fileOffset=o,this._readIFD(e,t,i,r,s))}return null}async _fillOffsets(e,t,i,r){const s=e.filter(e=>null!=e.offlineOffsetSize);if(0===s.length)return;const a=s.map(e=>e.offlineOffsetSize),n=Math.min.apply(null,a.map(e=>e[0])),o=Math.max.apply(null,a.map(e=>e[0]+e[1]));let f=1===a.length||o-n<=this._bufferSize;if(!f&&a.length>1){a.sort((e,t)=>e[0]-t[0]);f=a.reduce((e,t)=>e===t[0]?t[0]+t[1]:0,a[0][0])===o}if(f){const e=await this._fetchOffsets(n,Math.max(o,n+this._bufferSize),r);return void s.forEach(i=>y(e,t,i,n))}const l=s.map(async e=>{const i=e.offlineOffsetSize,s=await this._fetchOffsets(i[0],i[1]+i[0],r);y(s,t,e,i[0])});await Promise.all(l)}async _fetchOffsets(e,t,i){const r=[],s=this._chunkSize,a=Math.ceil((t-e)/s);let n=e;for(let l=0;l<a;l++)r.push(this.request(this.url,{range:{from:n,to:l===a-1?t:n+s-1},responseType:"array-buffer",signal:i})),n+=s;const o=await Promise.all(r);if(1===a)return o[0].data;const f=new Uint8Array(t-e+1);for(let l=0;l<a;l++)f.set(new Uint8Array(o[l].data),l*s);return f.buffer}async _fetchRawTiffTile(e,t,i,r,s={}){const a=this._getTileLocation(e,t,i,r);if(!a)return null;const{ranges:n,actualTileWidth:o,actualTileHeight:f,ifd:l}=a,u=n.map(e=>this.request(this.url,{range:e,responseType:"array-buffer",signal:s.signal})),c=await Promise.all(u),h=c.map(e=>e.data.byteLength).reduce((e,t)=>e+t),p=1===c.length?c[0].data:new ArrayBuffer(h),d=[0],m=[0];if(c.length>1){const e=new Uint8Array(p);for(let t=0,i=0;t<c.length;t++){const r=c[t].data;e.set(new Uint8Array(r),i),d[t]=i,i+=r.byteLength,m[t]=r.byteLength}}const{blockWidth:y,blockHeight:g}=this.getBlockWidthHeight(e),x=await this.decodePixelBlock(p,{format:"tiff",customOptions:{headerInfo:this._headerInfo,ifd:l,offsets:d,sizes:m},width:y,height:g,planes:null,pixelType:null});if(null==x)return null;let w,I,T;if(o!==y||f!==g){let e=x.mask;if(e)for(w=0;w<g;w++)if(T=w*y,w<f)for(I=o;I<y;I++)e[T+I]=0;else for(I=0;I<y;I++)e[T+I]=0;else for(e=new Uint8Array(y*g),x.mask=e,w=0;w<f;w++)for(T=w*y,I=0;I<o;I++)e[T+I]=1}return x}_getTileLocation(e,t,i,r=!1){const{firstPyramidLevel:s,blockBoundary:a}=this.rasterInfo.storageInfo,n=0===e?0:e-(s-1),{_headerInfo:o}=this;if(!o)return null;const f=r?o.maskIFDs[n]:0===n?o?.ifds[0]:o?.pyramidIFDs[n-1];if(!f)return null;const l=g(f,o),u=S(f,"TILEOFFSETS");if(void 0===u)return null;const c=S(f,"TILEBYTECOUNTS"),{minRow:h,minCol:p,maxRow:d,maxCol:m}=a[n];if(t>d||i>m||t<h||i<p)return null;const y=b(f,"IMAGEWIDTH"),x=b(f,"IMAGELENGTH"),w=b(f,"TILEWIDTH"),I=b(f,"TILELENGTH"),T=[];if(l){const{bandCount:e}=this.rasterInfo;for(let r=0;r<e;r++){const e=r*(d+1)*(m+1)+t*(m+1)+i;T[r]={from:u[e],to:u[e]+c[e]-1}}}else{const e=t*(m+1)+i;T.push({from:u[e],to:u[e]+c[e]-1})}for(let g=0;g<T.length;g++)if(null==T[g].from||!T[g].to||T[g].to<0)return null;return{ranges:T,ifd:f,actualTileWidth:i===m&&y%w||w,actualTileHeight:t===d&&x%I||I}}async _fetchAuxiliaryMetaData(e){try{const{data:t}=await this.request(this.url+".aux.xml",{responseType:"xml",signal:e?.signal});return u(t)}catch{return null}}async _fetchAuxiliaryTable(e){try{const{data:t}=await this.request(this.url+".vat.dbf",{responseType:"array-buffer",signal:e?.signal}),i=l.parse(t);return i?.recordSet?F.fromJSON(i.recordSet):null}catch{return null}}};function k(e){const t=x(e),{width:i,height:r,tileWidth:s,tileHeight:f,planes:l,pixelType:u,compression:h,firstPyramidLevel:p,maximumPyramidLevel:d,pyramidBlockWidth:m,pyramidBlockHeight:y,pyramidResolutions:g,tileBoundary:w,affine:I,metadata:T}=t,F=t.extent.spatialReference?.wkt||t.extent.spatialReference?.wkid;let E=c(F),k=!!t.isPseudoGeographic;null==E&&(k=!0,E=new o({wkid:3857}));const v=new a({...t.extent,spatialReference:E}),D=new n(v?{x:v.xmin,y:v.ymax,spatialReference:E}:{x:0,y:0}),P=new O({blockWidth:s,blockHeight:f,pyramidBlockWidth:m,pyramidBlockHeight:y,compression:h,origin:D,firstPyramidLevel:p,maximumPyramidLevel:d,pyramidResolutions:g,blockBoundary:w}),B=new n({x:(v.xmax-v.xmin)/i,y:(v.ymax-v.ymin)/r,spatialReference:E}),z=T?{BandProperties:T.bandProperties,DataType:T.dataType}:{};let C=null;const L=b(e[0],"PHOTOMETRICINTERPRETATION"),j=S(e[0],"COLORMAP");if(L<=3&&j?.length>3&&j.length%3==0){C=[];const e=j.length/3;for(let t=0;t<e;t++)C.push([t,j[t]>>>8,j[t+e]>>>8,j[t+2*e]>>>8])}const A=new _({width:i,height:r,bandCount:l,pixelType:u,pixelSize:B,storageInfo:P,spatialReference:E,isPseudoSpatialReference:k,keyProperties:z,extent:v,colormap:C,statistics:T?T.statistics:null});if(I?.length&&(A.nativeExtent=new a({xmin:-.5,ymin:.5-r,xmax:i-.5,ymax:.5,spatialReference:E}),A.transform=new R({polynomialOrder:1,forwardCoefficients:[I[2]+I[0]/2,I[5]-I[3]/2,I[0],I[3],-I[1],-I[4]]}),A.extent=A.transform.forwardTransform(A.nativeExtent),A.pixelSize=new n({x:(v.xmax-v.xmin)/i,y:(v.ymax-v.ymin)/r,spatialReference:E}),P.origin.x=-.5,P.origin.y=.5),g){const{x:e,y:t}=A.pixelSize;g.forEach(i=>{i.x*=e,i.y*=t})}return{imageInfo:t,rasterInfo:A}}function v(e,t){if(t.statistics=e.statistics??t.statistics,t.histograms=e.histograms,e.histograms&&null==t.statistics&&(t.statistics=T(e.histograms)),e.transform&&null==t.transform){t.transform=e.transform,t.nativeExtent=t.extent;const i=t.transform.forwardTransform(t.nativeExtent);t.pixelSize=new n({x:(i.xmax-i.xmin)/t.width,y:(i.ymax-i.ymin)/t.height,spatialReference:t.spatialReference}),t.extent=i}t.isPseudoSpatialReference&&e.spatialReference&&(t.spatialReference=e.spatialReference,t.extent.spatialReference=t.nativeExtent.spatialReference=t.storageInfo.origin.spatialReference=t.spatialReference)}e([r()],E.prototype,"_files",void 0),e([r()],E.prototype,"_headerInfo",void 0),e([r()],E.prototype,"_bufferSize",void 0),e([r()],E.prototype,"_chunkSize",void 0),e([r({type:String,json:{write:!0}})],E.prototype,"datasetFormat",void 0),E=e([s("esri.layers.raster.datasets.TIFFRaster")],E);const D=E;export{D as default};
+import{__decorate as e}from"tslib";import t from"../../../core/Error.js";import"../../../core/has.js";import i from"../../../core/Logger.js";import{property as r,subclass as s}from"../../../core/accessorSupport/decorators.js";import a from"../../../geometry/Extent.js";import n from"../../../geometry/Point.js";import o from"../../../geometry/SpatialReference.js";import f from"./BaseRaster.js";import l from"./DBFParser.js";import{parsePAMInfo as u,parseSpatialReference as c}from"./pamParser.js";import{parseSignature as h,getPyramidIFDs as p,getMaskIFDs as d,parseIFD as m,parseFieldValues as y,isBSQConfig as g,getImageInfo as x}from"../formats/TiffDecoder.js";import{tiffTags as w,geoKeys as I}from"../formats/tiffTag.js";import{estimateStatisticsFromHistograms as T}from"../functions/stretchUtils.js";import R from"../transforms/PolynomialTransform.js";import _ from"../../support/RasterInfo.js";import O from"../../support/RasterStorageInfo.js";import F from"../../../rest/support/FeatureSet.js";const S=(e,t)=>e.get(t)?.values,b=(e,t)=>e.get(t)?.values?.[0];let E=class extends f{constructor(){super(...arguments),this._files=null,this._headerInfo=null,this._bufferSize=1048576,this._chunkSize=10485760,this.datasetFormat="TIFF"}async fetchRawTile(e,t,i,r={}){if(!this._headerInfo?.isSupported||this.isBlockOutside(e,t,i))return null;const s=await this._fetchRawTiffTile(e,t,i,!1,r);if(null!=s&&this._headerInfo.hasMaskBand){const a=await this._fetchRawTiffTile(e,t,i,!0,r);null!=a&&a.pixels[0]instanceof Uint8Array&&(s.mask=a.pixels[0])}return s}async _open(e){const r=e?e.signal:null,{data:s}=await this.request(this.url,{range:{from:0,to:this._bufferSize},responseType:"array-buffer",signal:r});if(!s)throw new t("tiffraster:open","failed to open url "+this.url);this.datasetName=this.url.slice(this.url.lastIndexOf("/")+1,this.url.lastIndexOf("."));const{littleEndian:a,firstIFDPos:n,isBigTiff:o}=h(s),f=[],l={fileChunk:s,posIFD:n,fileOffset:0};await this._readIFDs(f,l,a,o?8:4,r);const{imageInfo:u,rasterInfo:c}=k(f),m=p(f),y=d(f);if(this._headerInfo={littleEndian:a,isBigTiff:o,ifds:f,pyramidIFDs:m,maskIFDs:y,...u},this._set("rasterInfo",c),!u.isSupported)throw new t("tiffraster:open","this tiff is not supported: "+u.message);if(!u.tileWidth)throw new t("tiffraster:open","none-tiled tiff is not optimized for access, convert to COG and retry.");c.isPseudoSpatialReference&&i.getLogger(this).warn("The spatial reference for this tiff is unsupported. Only EPSG spatial reference codes and Esri WKTs are supported.");const g=f[0].get("PREDICTOR")?.values?.[0],x=f[0].get("SAMPLEFORMAT")?.values?.[0];if(3===x&&2===g)throw new t("tiffraster:open","unsupported horizontal difference encoding. Predictor=3 is supported for floating point data");const{skipMapInfo:w,skipExtensions:I=[]}=this.ioConfig;if(!I.includes("aux.xml")&&!w){const t=await this._fetchAuxiliaryMetaData(e);null!=t&&v(t,c)}I.includes("vat.dbf")||1!==c.bandCount||"u8"!==c.pixelType||w||(c.attributeTable=await this._fetchAuxiliaryTable(e),null!=c.attributeTable&&(c.keyProperties.DataType="thematic")),w&&this.updateImageSpaceRasterInfo(c),this.updateTileInfo()}async _validateOrFetchHeaderBuffer(e,t){let{fileChunk:i,fileOffset:r,posIFD:s}=e;if(s+8>=i.byteLength||s<0){r=s+r;i=(await this.request(this.url,{range:{from:r,to:r+this._bufferSize},responseType:"array-buffer",signal:t})).data,s=0}return{fileChunk:i,fileOffset:r,posIFD:s}}async _readIFDs(e,i,r,s=4,a){if(!i.posIFD)return null;i=await this._validateOrFetchHeaderBuffer(i,a);const n=await this._readIFD(i,r,w,s,a);if(!n?.ifd)throw new t("tiffraster:open","cannot parse tiff header. failed to open url "+this.url);if(e.push(n.ifd),!n.nextIFD)return null;i.posIFD=n.nextIFD-i.fileOffset,await this._readIFDs(e,i,r,s,a)}async _readIFD(e,t,i=w,r=4,s){let{fileChunk:a,posIFD:n,fileOffset:o}=e;if(!e.fileChunk)return null;const f=m(a,t,n,o,i,r);if(f.success){const e=[];if(f.ifd?.forEach(t=>{t.values||e.push(t)}),e.length>0&&await this._fillOffsets(e,t,f.nextIFD,s),f.ifd?.has("GEOKEYDIRECTORY")){const e=f.ifd.get("GEOKEYDIRECTORY"),i=e?.values;if(i&&i.length>4){const r=i[0]+"."+i[1]+"."+i[2];n=e.valueOffset+6-o;const f=await this._validateOrFetchHeaderBuffer({fileChunk:a,posIFD:n,fileOffset:o},s),l=await this._readIFD(f,t,I,2,s);e.data=l?.ifd,e.data&&e.data.set("GEOTIFFVersion",{id:0,type:2,valueCount:1,valueOffset:null,values:[r]})}}return f}if(f.requiredBufferSize){return a=(await this.request(this.url,{range:{from:o,to:o+n+f.requiredBufferSize+8},responseType:"array-buffer",signal:s})).data,a.byteLength<n+f.requiredBufferSize?null:(e.fileChunk=a,e.fileOffset=o,this._readIFD(e,t,i,r,s))}return null}async _fillOffsets(e,t,i,r){const s=e.filter(e=>null!=e.offlineOffsetSize);if(0===s.length)return;const a=s.map(e=>e.offlineOffsetSize),n=Math.min.apply(null,a.map(e=>e[0])),o=Math.max.apply(null,a.map(e=>e[0]+e[1]));let f=1===a.length||o-n<=this._bufferSize;if(!f&&a.length>1){a.sort((e,t)=>e[0]-t[0]);f=a.reduce((e,t)=>e===t[0]?t[0]+t[1]:0,a[0][0])===o}if(f){const e=await this._fetchOffsets(n,Math.max(o,n+this._bufferSize),r);return void s.forEach(i=>y(e,t,i,n))}const l=s.map(async e=>{const i=e.offlineOffsetSize,s=await this._fetchOffsets(i[0],i[1]+i[0],r);y(s,t,e,i[0])});await Promise.all(l)}async _fetchOffsets(e,t,i){const r=[],s=this._chunkSize,a=Math.ceil((t-e)/s);let n=e;for(let l=0;l<a;l++)r.push(this.request(this.url,{range:{from:n,to:l===a-1?t:n+s-1},responseType:"array-buffer",signal:i})),n+=s;const o=await Promise.all(r);if(1===a)return o[0].data;const f=new Uint8Array(t-e+1);for(let l=0;l<a;l++)f.set(new Uint8Array(o[l].data),l*s);return f.buffer}async _fetchRawTiffTile(e,t,i,r,s={}){const a=this._getTileLocation(e,t,i,r);if(!a)return null;const{ranges:n,actualTileWidth:o,actualTileHeight:f,ifd:l}=a,u=n.map(e=>this.request(this.url,{range:e,responseType:"array-buffer",signal:s.signal})),c=await Promise.all(u),h=c.map(e=>e.data.byteLength).reduce((e,t)=>e+t),p=1===c.length?c[0].data:new ArrayBuffer(h),d=[0],m=[0];if(c.length>1){const e=new Uint8Array(p);for(let t=0,i=0;t<c.length;t++){const r=c[t].data;e.set(new Uint8Array(r),i),d[t]=i,i+=r.byteLength,m[t]=r.byteLength}}const{blockWidth:y,blockHeight:g}=this.getBlockWidthHeight(e),x=await this.decodePixelBlock(p,{format:"tiff",customOptions:{headerInfo:this._headerInfo,ifd:l,offsets:d,sizes:m},width:y,height:g,planes:null,pixelType:null});if(null==x)return null;if(o!==y||f!==g){let e=x.mask;if(e)for(let t=0;t<g;t++){const i=t*y;if(t<f)for(let t=o;t<y;t++)e[i+t]=0;else for(let t=0;t<y;t++)e[i+t]=0}else{e=new Uint8Array(y*g),x.mask=e;for(let t=0;t<f;t++){const i=t*y;for(let t=0;t<o;t++)e[i+t]=1}}}return x}_getTileLocation(e,t,i,r=!1){const{firstPyramidLevel:s,blockBoundary:a}=this.rasterInfo.storageInfo,n=0===e?0:e-(s-1),{_headerInfo:o}=this;if(!o)return null;const f=r?o.maskIFDs[n]:0===n?o?.ifds[0]:o?.pyramidIFDs[n-1];if(!f)return null;const l=g(f,o),u=S(f,"TILEOFFSETS");if(void 0===u)return null;const c=S(f,"TILEBYTECOUNTS"),{minRow:h,minCol:p,maxRow:d,maxCol:m}=a[n];if(t>d||i>m||t<h||i<p)return null;const y=b(f,"IMAGEWIDTH"),x=b(f,"IMAGELENGTH"),w=b(f,"TILEWIDTH"),I=b(f,"TILELENGTH"),T=[];if(l){const{bandCount:e}=this.rasterInfo;for(let r=0;r<e;r++){const e=r*(d+1)*(m+1)+t*(m+1)+i;T[r]={from:u[e],to:u[e]+c[e]-1}}}else{const e=t*(m+1)+i;T.push({from:u[e],to:u[e]+c[e]-1})}for(let g=0;g<T.length;g++)if(null==T[g].from||!T[g].to||T[g].to<0)return null;return{ranges:T,ifd:f,actualTileWidth:i===m&&y%w||w,actualTileHeight:t===d&&x%I||I}}async _fetchAuxiliaryMetaData(e){try{const{data:t}=await this.request(this.url+".aux.xml",{responseType:"xml",signal:e?.signal});return u(t)}catch{return null}}async _fetchAuxiliaryTable(e){try{const{data:t}=await this.request(this.url+".vat.dbf",{responseType:"array-buffer",signal:e?.signal}),i=l.parse(t);return i?.recordSet?F.fromJSON(i.recordSet):null}catch{return null}}};function k(e){const t=x(e),{width:i,height:r,tileWidth:s,tileHeight:f,planes:l,pixelType:u,compression:h,firstPyramidLevel:p,maximumPyramidLevel:d,pyramidBlockWidth:m,pyramidBlockHeight:y,pyramidResolutions:g,tileBoundary:w,affine:I,metadata:T}=t,F=t.extent.spatialReference?.wkt||t.extent.spatialReference?.wkid;let E=c(F),k=!!t.isPseudoGeographic;null==E&&(k=!0,E=new o({wkid:3857}));const v=new a({...t.extent,spatialReference:E}),D=new n(v?{x:v.xmin,y:v.ymax,spatialReference:E}:{x:0,y:0}),P=new O({blockWidth:s,blockHeight:f,pyramidBlockWidth:m,pyramidBlockHeight:y,compression:h,origin:D,firstPyramidLevel:p,maximumPyramidLevel:d,pyramidResolutions:g,blockBoundary:w}),B=new n({x:(v.xmax-v.xmin)/i,y:(v.ymax-v.ymin)/r,spatialReference:E}),z=T?{BandProperties:T.bandProperties,DataType:T.dataType}:{};let C=null;const L=b(e[0],"PHOTOMETRICINTERPRETATION"),j=S(e[0],"COLORMAP");if(L<=3&&j?.length>3&&j.length%3==0){C=[];const e=j.length/3;for(let t=0;t<e;t++)C.push([t,j[t]>>>8,j[t+e]>>>8,j[t+2*e]>>>8])}const A=new _({width:i,height:r,bandCount:l,pixelType:u,pixelSize:B,storageInfo:P,spatialReference:E,isPseudoSpatialReference:k,keyProperties:z,extent:v,colormap:C,statistics:T?T.statistics:null});if(I?.length&&(A.nativeExtent=new a({xmin:-.5,ymin:.5-r,xmax:i-.5,ymax:.5,spatialReference:E}),A.transform=new R({polynomialOrder:1,forwardCoefficients:[I[2]+I[0]/2,I[5]-I[3]/2,I[0],I[3],-I[1],-I[4]]}),A.extent=A.transform.forwardTransform(A.nativeExtent),A.pixelSize=new n({x:(v.xmax-v.xmin)/i,y:(v.ymax-v.ymin)/r,spatialReference:E}),P.origin.x=-.5,P.origin.y=.5),g){const{x:e,y:t}=A.pixelSize;g.forEach(i=>{i.x*=e,i.y*=t})}return{imageInfo:t,rasterInfo:A}}function v(e,t){if(t.statistics=e.statistics??t.statistics,t.histograms=e.histograms,e.histograms&&null==t.statistics&&(t.statistics=T(e.histograms)),e.transform&&null==t.transform){t.transform=e.transform,t.nativeExtent=t.extent;const i=t.transform.forwardTransform(t.nativeExtent);t.pixelSize=new n({x:(i.xmax-i.xmin)/t.width,y:(i.ymax-i.ymin)/t.height,spatialReference:t.spatialReference}),t.extent=i}t.isPseudoSpatialReference&&e.spatialReference&&(t.spatialReference=e.spatialReference,t.extent.spatialReference=t.nativeExtent.spatialReference=t.storageInfo.origin.spatialReference=t.spatialReference)}e([r()],E.prototype,"_files",void 0),e([r()],E.prototype,"_headerInfo",void 0),e([r()],E.prototype,"_bufferSize",void 0),e([r()],E.prototype,"_chunkSize",void 0),e([r({type:String,json:{write:!0}})],E.prototype,"datasetFormat",void 0),E=e([s("esri.layers.raster.datasets.TIFFRaster")],E);const D=E;export{D as default};

package/layers/raster/datasets/pixelReader.d.ts

@@ -1,4 +1,6 @@
 
+/** @since 5.0 */
 export interface IteratorRecord {}
 
+/** @since 5.0 */
 export interface PixelData {}

package/layers/raster/datasets/types.d.ts

@@ -1,2 +1,3 @@
 
+/** @since 5.0 */
 export type WCSVersion = "1.0.0" | "1.1.0" | "1.1.1" | "1.1.2" | "2.0.1";

package/layers/raster/datasets/wcsCapabilitiesParser.d.ts

@@ -1,48 +1,117 @@
 import type Extent from "../../../geometry/Extent.js";
 import type { WCSVersion } from "./types.js";
 
-/** Coverage information associated with a WCS service. */
+/**
+ * Coverage information associated with a WCS service.
+ *
+ * @since 5.0
+ */
 export interface CoverageBrief {
-  /** The subtype of the coverage. */
+  /**
+   * The subtype of the coverage.
+   *
+   * @since 5.0
+   */
   coverageSubType?: string;
-  /** The id of the coverage. */
+  /**
+   * The id of the coverage.
+   *
+   * @since 5.0
+   */
   id: string;
-  /** The extent of the coverage. */
+  /**
+   * The extent of the coverage.
+   *
+   * @since 5.0
+   */
   lonLatEnvelope?: Extent;
 }
 
-/** A list of URLs for the WCS service resources. It is necessary for a WCS client to communicate correctly with your WCS service. */
+/**
+ * A list of URLs for the WCS service resources. It is necessary for a WCS client to communicate correctly with your WCS service.
+ *
+ * @since 5.0
+ */
 export interface OnlineResources {
-  /** The URL to the describeCoverage endpoint. */
+  /**
+   * The URL to the describeCoverage endpoint.
+   *
+   * @since 5.0
+   */
   describeCoverage: string;
-  /** The URL to the getCapabilities endpoint. */
+  /**
+   * The URL to the getCapabilities endpoint.
+   *
+   * @since 5.0
+   */
   getCapabilities: string;
-  /** The URL to the getCoverage endpoint. */
+  /**
+   * The URL to the getCoverage endpoint.
+   *
+   * @since 5.0
+   */
   getCoverage: string;
 }
 
 /**
  * WCS service information about the available coverages, versions, extensions and more.
  *
+ * @since 5.0
  * @see [getCapabilities()](https://developers.arcgis.com/javascript/latest/api-reference/esri-layers-ogc-wcsUtils.html#getCapabilities)
  */
 export interface WCSCapabilities {
-  /** Information about the available coverages. */
+  /**
+   * Information about the available coverages.
+   *
+   * @since 5.0
+   */
   coverages: CoverageBrief[];
-  /** Information about the available grid coverages. */
+  /**
+   * Information about the available grid coverages.
+   *
+   * @since 5.0
+   */
   gridCoverages: CoverageBrief[];
-  /** Name of the WCS service. */
+  /**
+   * Name of the WCS service.
+   *
+   * @since 5.0
+   */
   name: string;
-  /** Online resources for the WCS service. */
+  /**
+   * Online resources for the WCS service.
+   *
+   * @since 5.0
+   */
   onlineResources: OnlineResources;
-  /** Application profiles supported by the WCS service. */
+  /**
+   * Application profiles supported by the WCS service.
+   *
+   * @since 5.0
+   */
   profiles?: string[];
-  /** Formats supported by the WCS service. */
+  /**
+   * Formats supported by the WCS service.
+   *
+   * @since 5.0
+   */
   supportedFormats?: string[];
-  /** Interpolations supported by the WCS service. */
+  /**
+   * Interpolations supported by the WCS service.
+   *
+   * @since 5.0
+   */
   supportedInterpolations?: string[];
-  /** The versions supported by the WCS service. */
+  /**
+   * The versions supported by the WCS service.
+   *
+   * @since 5.0
+   */
   supportedVersions: string[];
-  /** The WCS service version. */
+  /**
+   * The WCS service version.
+   *
+   * @since 5.0
+   */
   version: WCSVersion;
 }