Fixed: Updated configure comment

Updated comment to make it clear that it's a static method. Also updated the example
to IIIF v2, since that's more widely used than v1.1.
This commit is contained in:
Andrew Hankinson 2022-06-17 10:34:31 +02:00
parent 86dabe624b
commit d35c0a6385

View File

@ -183,23 +183,29 @@ $.extend( $.IIIFTileSource.prototype, $.TileSource.prototype, /** @lends OpenSea
}, },
/** /**
* A static function used to prepare an incoming IIIF Image API info.json
* response for processing by the tile handler. Normalizes data for all
* versions of IIIF (1.0, 1.1, 2.x, 3.x) and returns a data object that
* may be passed to the IIIFTileSource.
* *
* @function * @function
* @static
* @param {Object} data - the raw configuration * @param {Object} data - the raw configuration
* @param {String} url - the url configuration was retrieved from * @param {String} url - the url configuration was retrieved from
* @param {String} postData - HTTP POST data in k=v&k2=v2... form or null * @param {String} postData - HTTP POST data in k=v&k2=v2... form or null
* @example <caption>IIIF 1.1 Info Looks like this</caption> * @return {Object} A normalized IIIF data object
* @example <caption>IIIF 2.x Info Looks like this</caption>
* { * {
* "@context" : "http://library.stanford.edu/iiif/image-api/1.1/context.json", * "@context": "http://iiif.io/api/image/2/context.json",
* "@id": "http://iiif.example.com/prefix/1E34750D-38DB-4825-A38A-B60A345E591C", * "@id": "http://iiif.example.com/prefix/1E34750D-38DB-4825-A38A-B60A345E591C",
* "width" : 6000, * "protocol": "http://iiif.io/api/image",
* "height" : 4000, * "height": 1024,
* "scale_factors" : [ 1, 2, 4 ], * "width": 775,
* "tile_width" : 1024, * "tiles" : [{"width":256, "scaleFactors":[1,2,4,8]}],
* "tile_height" : 1024, * "profile": ["http://iiif.io/api/image/2/level1.json", {
* "formats" : [ "jpg", "png" ], * "qualities": [ "native", "bitonal", "grey", "color" ],
* "qualities" : [ "native", "grey" ], * "formats": [ "jpg", "png", "gif" ]
* "profile" : "http://library.stanford.edu/iiif/image-api/1.1/compliance.html#level0" * }]
* } * }
*/ */
configure: function( data, url, postData ){ configure: function( data, url, postData ){