blob: 972e490af0d54e5dcbd220ff65a55384afab6e61 [file] [log] [blame]
<!DOCTYPE HTML>
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc (11.0.4) on Fri Sep 20 12:10:30 CEST 2019 -->
<title>DefaultResolution (Apache SIS 1.0 API)</title>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta name="dc.created" content="2019-09-20">
<meta name="keywords" content="org.apache.sis.metadata.iso.identification.DefaultResolution class">
<meta name="keywords" content="castOrCopy()">
<meta name="keywords" content="getEquivalentScale()">
<meta name="keywords" content="setEquivalentScale()">
<meta name="keywords" content="getDistance()">
<meta name="keywords" content="setDistance()">
<meta name="keywords" content="getVertical()">
<meta name="keywords" content="setVertical()">
<meta name="keywords" content="getAngularDistance()">
<meta name="keywords" content="setAngularDistance()">
<meta name="keywords" content="getLevelOfDetail()">
<meta name="keywords" content="setLevelOfDetail()">
<link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="Style">
<link rel="stylesheet" type="text/css" href="../../../../../../sis.css" title="Style">
<link rel="stylesheet" type="text/css" href="../../../../../../jquery/jquery-ui.css" title="Style">
<script type="text/javascript" src="../../../../../../script.js"></script>
<script type="text/javascript" src="../../../../../../jquery/jszip/dist/jszip.min.js"></script>
<script type="text/javascript" src="../../../../../../jquery/jszip-utils/dist/jszip-utils.min.js"></script>
<!--[if IE]>
<script type="text/javascript" src="../../../../../../jquery/jszip-utils/dist/jszip-utils-ie.min.js"></script>
<![endif]-->
<script type="text/javascript" src="../../../../../../jquery/jquery-3.3.1.js"></script>
<script type="text/javascript" src="../../../../../../jquery/jquery-migrate-3.0.1.js"></script>
<script type="text/javascript" src="../../../../../../jquery/jquery-ui.js"></script>
</head>
<body>
<script type="text/javascript"><!--
try {
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="DefaultResolution (Apache SIS 1.0 API)";
}
}
catch(err) {
}
//-->
var data = {"i0":9,"i1":10,"i2":10,"i3":10,"i4":10,"i5":10,"i6":10,"i7":10,"i8":10,"i9":10,"i10":10};
var tabs = {65535:["t0","All Methods"],1:["t1","Static Methods"],2:["t2","Instance Methods"],8:["t4","Concrete Methods"]};
var altColor = "altColor";
var rowColor = "rowColor";
var tableTab = "tableTab";
var activeTableTab = "activeTableTab";
var pathtoroot = "../../../../../../";
var useModuleDirectories = false;
loadScripts(document, 'script');</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<header role="banner">
<nav role="navigation">
<div class="fixedNav">
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a id="navbar.top">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.top" title="Skip navigation links">Skip navigation links</a></div>
<a id="navbar.top.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../../../index.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/DefaultResolution.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../../../index-all.html">Index</a></li>
<li><a href="../../../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../../../../allclasses.html">All&nbsp;Classes</a></li>
</ul>
<ul class="navListSearch">
<li><label for="search">SEARCH:</label>
<input type="text" id="search" value="search" disabled="disabled">
<input type="reset" id="reset" value="reset" disabled="disabled">
</li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_top");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li><a href="#nested.class.summary">Nested</a>&nbsp;|&nbsp;</li>
<li><a href="#field.summary">Field</a>&nbsp;|&nbsp;</li>
<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a id="skip.navbar.top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
</div>
<div class="navPadding">&nbsp;</div>
<script type="text/javascript"><!--
$('.navPadding').css('padding-top', $('.fixedNav').css("height"));
//-->
</script>
</nav>
</header>
<!-- ======== START OF CLASS DATA ======== -->
<main role="main">
<div class="header">
<div class="subTitle"><span class="packageLabelInType">Package</span>&nbsp;<a href="package-summary.html">org.apache.sis.metadata.iso.identification</a></div>
<h2 title="Class DefaultResolution" class="title">Class DefaultResolution</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang" class="externalLink">Object</a></li>
<li>
<ul class="inheritance">
<li><a href="../../AbstractMetadata.html" title="class in org.apache.sis.metadata">AbstractMetadata</a></li>
<li>
<ul class="inheritance">
<li><a href="../../ModifiableMetadata.html" title="class in org.apache.sis.metadata">ModifiableMetadata</a></li>
<li>
<ul class="inheritance">
<li><a href="../ISOMetadata.html" title="class in org.apache.sis.metadata.iso">ISOMetadata</a></li>
<li>
<ul class="inheritance">
<li>DefaultResolution</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>All Implemented Interfaces:</dt>
<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/io/Serializable.html?is-external=true" title="class or interface in java.io" class="externalLink">Serializable</a></code>, <code><a href="../../../util/Emptiable.html" title="interface in org.apache.sis.util">Emptiable</a></code>, <code><a href="../../../util/LenientComparable.html" title="interface in org.apache.sis.util">Lenient­Comparable</a></code>, <code><a href="../../../xml/IdentifiedObject.html" title="interface in org.apache.sis.xml">Identified­Object</a></code>, <code><a href="http://www.geoapi.org/3.0/javadoc/org/opengis/metadata/identification/Resolution.html?is-external=true" title="class or interface in org.opengis.metadata.identification" class="externalLink">Resolution</a></code></dd>
</dl>
<hr>
<pre>public class <span class="typeNameLabel">DefaultResolution</span>
extends <a href="../ISOMetadata.html" title="class in org.apache.sis.metadata.iso">ISOMetadata</a>
implements <a href="http://www.geoapi.org/3.0/javadoc/org/opengis/metadata/identification/Resolution.html?is-external=true" title="class or interface in org.opengis.metadata.identification" class="externalLink">Resolution</a></pre>
<div class="block">Level of detail expressed as a scale factor or a ground distance.
The following properties are mandatory or conditional (i.e. mandatory under some circumstances)
in a well-formed metadata according ISO 19115:
<div class="preformat"><code>MD_Resolution</code>
<code>  ├─angular­Distance……</code> Angular sampling measure.
<code>  ├─distance………………………</code> Ground sample distance.
<code>  ├─equivalent­Scale……</code> Level of detail expressed as the scale of a comparable hardcopy map or chart.
<code>  │   └─denominator……</code> The number below the line in a vulgar fraction.
<code>  ├─level­Of­Detail…………</code> Brief textual description of the spatial resolution of the resource.
<code>  └─vertical………………………</code> Vertical sampling distance.</div>
ISO 19115 defines <code>Resolution</code> as an <cite>union</cite> (in the C/C++ sense):
only one of the properties in this class can be set to a non-empty value.
Setting any property to a non-empty value discard all the other ones.
See the <a href="#%3Cinit%3E(org.opengis.metadata.identification.Resolution)">constructor javadoc</a>
for information about which property has precedence on copy operations.
<div class="section">Limitations</div>
<ul>
<li>Instances of this class are not synchronized for multi-threading.
Synchronization, if needed, is caller's responsibility.</li>
<li>Serialized objects of this class are not guaranteed to be compatible with future Apache SIS releases.
Serialization support is appropriate for short term storage or RMI between applications running the
same version of Apache SIS. For long term storage, use <a href="../../../xml/XML.html" title="class in org.apache.sis.xml"><code>XML</code></a> instead.</li>
</ul></div>
<dl>
<dt><span class="simpleTagLabel">Since:</span></dt>
<dd>0.3</dd>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="AbstractIdentification.html#getSpatialResolutions()"><code>Abstract­Identification​.get­Spatial­Resolutions()</code></a>,
<a href="../../../../../../serialized-form.html#org.apache.sis.metadata.iso.identification.DefaultResolution">Serialized Form</a></dd>
<p><font size="-1">Defined in the <code>sis-metadata</code> module</font></p>
</dl>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- ======== NESTED CLASS SUMMARY ======== -->
<section role="region">
<ul class="blockList">
<li class="blockList"><a id="nested.class.summary">
<!-- -->
</a>
<h3>Nested Class Summary</h3>
<ul class="blockList">
<li class="blockList"><a id="nested.classes.inherited.from.class.org.apache.sis.metadata.ModifiableMetadata">
<!-- -->
</a>
<h3>Nested classes/interfaces inherited from class&nbsp;<a href="../../ModifiableMetadata.html" title="class in org.apache.sis.metadata">ModifiableMetadata</a></h3>
<code><a href="../../ModifiableMetadata.State.html" title="enum in org.apache.sis.metadata">Modifiable­Metadata​.State</a></code></li>
</ul>
</li>
</ul>
</section>
<!-- =========== FIELD SUMMARY =========== -->
<section role="region">
<ul class="blockList">
<li class="blockList"><a id="field.summary">
<!-- -->
</a>
<h3>Field Summary</h3>
<ul class="blockList">
<li class="blockList"><a id="fields.inherited.from.class.ISOMetadata">
<!-- -->
</a>
<h3>Fields inherited from class&nbsp;<a href="../ISOMetadata.html" title="class in org.apache.sis.metadata.iso">ISOMetadata</a></h3>
<code><a href="../ISOMetadata.html#identifiers">identifiers</a></code></li>
</ul>
</li>
</ul>
</section>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<section role="region">
<ul class="blockList">
<li class="blockList"><a id="constructor.summary">
<!-- -->
</a>
<h3>Constructor Summary</h3>
<table class="memberSummary">
<caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Constructor</th>
<th class="colLast" scope="col">Description</th>
</tr>
<tr class="altColor">
<th class="colConstructorName" scope="row"><code><span class="memberNameLink"><a href="#%3Cinit%3E()">DefaultResolution</a></span>()</code></th>
<td class="colLast">
<div class="block">Constructs an initially empty resolution.</div>
</td>
</tr>
<tr class="rowColor">
<th class="colConstructorName" scope="row"><code><span class="memberNameLink"><a href="#%3Cinit%3E(org.opengis.metadata.identification.RepresentativeFraction)">DefaultResolution</a></span>&#8203;(<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/metadata/identification/RepresentativeFraction.html?is-external=true" title="class or interface in org.opengis.metadata.identification" class="externalLink">RepresentativeFraction</a>&nbsp;scale)</code></th>
<td class="colLast">
<div class="block">Creates a new resolution initialized to the given scale.</div>
</td>
</tr>
<tr class="altColor">
<th class="colConstructorName" scope="row"><code><span class="memberNameLink"><a href="#%3Cinit%3E(org.opengis.metadata.identification.Resolution)">DefaultResolution</a></span>&#8203;(<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/metadata/identification/Resolution.html?is-external=true" title="class or interface in org.opengis.metadata.identification" class="externalLink">Resolution</a>&nbsp;object)</code></th>
<td class="colLast">
<div class="block">Constructs a new instance initialized with the values from the specified metadata object.</div>
</td>
</tr>
</table>
</li>
</ul>
</section>
<!-- ========== METHOD SUMMARY =========== -->
<section role="region">
<ul class="blockList">
<li class="blockList"><a id="method.summary">
<!-- -->
</a>
<h3>Method Summary</h3>
<table class="memberSummary">
<caption><span id="t0" class="activeTableTab"><span>All Methods</span><span class="tabEnd">&nbsp;</span></span><span id="t1" class="tableTab"><span><a href="javascript:show(1);">Static Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t2" class="tableTab"><span><a href="javascript:show(2);">Instance Methods</a></span><span class="tabEnd">&nbsp;</span></span><span id="t4" class="tableTab"><span><a href="javascript:show(8);">Concrete Methods</a></span><span class="tabEnd">&nbsp;</span></span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colSecond" scope="col">Method</th>
<th class="colLast" scope="col">Description</th>
</tr>
<tr id="i0" class="altColor">
<td class="colFirst"><code>static <a href="DefaultResolution.html" title="class in org.apache.sis.metadata.iso.identification">DefaultResolution</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#castOrCopy(org.opengis.metadata.identification.Resolution)">castOrCopy</a></span>&#8203;(<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/metadata/identification/Resolution.html?is-external=true" title="class or interface in org.opengis.metadata.identification" class="externalLink">Resolution</a>&nbsp;object)</code></th>
<td class="colLast">
<div class="block">Returns a SIS metadata implementation with the values of the given arbitrary implementation.</div>
</td>
</tr>
<tr id="i1" class="rowColor">
<td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang" class="externalLink">Double</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getAngularDistance()">getAngularDistance</a></span>()</code></th>
<td class="colLast">
<div class="block">Returns the angular sampling measure.</div>
</td>
</tr>
<tr id="i2" class="altColor">
<td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang" class="externalLink">Double</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getDistance()">getDistance</a></span>()</code></th>
<td class="colLast">
<div class="block">Returns the ground sample distance.</div>
</td>
</tr>
<tr id="i3" class="rowColor">
<td class="colFirst"><code><a href="http://www.geoapi.org/3.0/javadoc/org/opengis/metadata/identification/RepresentativeFraction.html?is-external=true" title="class or interface in org.opengis.metadata.identification" class="externalLink">RepresentativeFraction</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getEquivalentScale()">getEquivalentScale</a></span>()</code></th>
<td class="colLast">
<div class="block">Returns the level of detail expressed as the scale of a comparable hardcopy map or chart.</div>
</td>
</tr>
<tr id="i4" class="altColor">
<td class="colFirst"><code><a href="http://www.geoapi.org/3.0/javadoc/org/opengis/util/InternationalString.html?is-external=true" title="class or interface in org.opengis.util" class="externalLink">InternationalString</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getLevelOfDetail()">getLevelOfDetail</a></span>()</code></th>
<td class="colLast">
<div class="block">Returns a brief textual description of the spatial resolution of the resource.</div>
</td>
</tr>
<tr id="i5" class="rowColor">
<td class="colFirst"><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang" class="externalLink">Double</a></code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#getVertical()">getVertical</a></span>()</code></th>
<td class="colLast">
<div class="block">Returns the vertical sampling distance.</div>
</td>
</tr>
<tr id="i6" class="altColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#setAngularDistance(java.lang.Double)">setAngularDistance</a></span>&#8203;(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang" class="externalLink">Double</a>&nbsp;newValue)</code></th>
<td class="colLast">
<div class="block">Sets the angular sampling measure.</div>
</td>
</tr>
<tr id="i7" class="rowColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#setDistance(java.lang.Double)">setDistance</a></span>&#8203;(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang" class="externalLink">Double</a>&nbsp;newValue)</code></th>
<td class="colLast">
<div class="block">Sets the ground sample distance.</div>
</td>
</tr>
<tr id="i8" class="altColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#setEquivalentScale(org.opengis.metadata.identification.RepresentativeFraction)">setEquivalentScale</a></span>&#8203;(<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/metadata/identification/RepresentativeFraction.html?is-external=true" title="class or interface in org.opengis.metadata.identification" class="externalLink">RepresentativeFraction</a>&nbsp;newValue)</code></th>
<td class="colLast">
<div class="block">Sets the level of detail expressed as the scale of a comparable hardcopy map or chart.</div>
</td>
</tr>
<tr id="i9" class="rowColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#setLevelOfDetail(org.opengis.util.InternationalString)">setLevelOfDetail</a></span>&#8203;(<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/util/InternationalString.html?is-external=true" title="class or interface in org.opengis.util" class="externalLink">InternationalString</a>&nbsp;newValue)</code></th>
<td class="colLast">
<div class="block">Sets the textual description of the spatial resolution of the resource.</div>
</td>
</tr>
<tr id="i10" class="altColor">
<td class="colFirst"><code>void</code></td>
<th class="colSecond" scope="row"><code><span class="memberNameLink"><a href="#setVertical(java.lang.Double)">setVertical</a></span>&#8203;(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang" class="externalLink">Double</a>&nbsp;newValue)</code></th>
<td class="colLast">
<div class="block">Sets the vertical sampling distance.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a id="methods.inherited.from.class.ISOMetadata">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;<a href="../ISOMetadata.html" title="class in org.apache.sis.metadata.iso">ISOMetadata</a></h3>
<code><a href="../ISOMetadata.html#getIdentifier()">get­Identifier</a>, <a href="../ISOMetadata.html#getIdentifierMap()">get­Identifier­Map</a>, <a href="../ISOMetadata.html#getIdentifiers()">get­Identifiers</a>, <a href="../ISOMetadata.html#getStandard()">get­Standard</a>, <a href="../ISOMetadata.html#setIdentifier(org.opengis.metadata.Identifier)">set­Identifier</a>, <a href="../ISOMetadata.html#transitionTo(org.apache.sis.metadata.ModifiableMetadata.State)">transition­To</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a id="methods.inherited.from.class.ModifiableMetadata">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;<a href="../../ModifiableMetadata.html" title="class in org.apache.sis.metadata">ModifiableMetadata</a></h3>
<code><a href="../../ModifiableMetadata.html#checkWritePermission()">check­Write­Permission</a>, <a href="../../ModifiableMetadata.html#checkWritePermission(java.lang.Object)">check­Write­Permission</a>, <a href="../../ModifiableMetadata.html#collectionType(java.lang.Class)">collection­Type</a>, <a href="../../ModifiableMetadata.html#copyCollection(java.util.Collection,java.lang.Class)">copy­Collection</a>, <a href="../../ModifiableMetadata.html#copyList(java.util.Collection,java.lang.Class)">copy­List</a>, <a href="../../ModifiableMetadata.html#copyMap(java.util.Map,java.lang.Class)">copy­Map</a>, <a href="../../ModifiableMetadata.html#copySet(java.util.Collection,java.lang.Class)">copy­Set</a>, <a href="../../ModifiableMetadata.html#freeze()">freeze</a>, <a href="../../ModifiableMetadata.html#isModifiable()">is­Modifiable</a>, <a href="../../ModifiableMetadata.html#nonNullCollection(java.util.Collection,java.lang.Class)">non­Null­Collection</a>, <a href="../../ModifiableMetadata.html#nonNullList(java.util.List,java.lang.Class)">non­Null­List</a>, <a href="../../ModifiableMetadata.html#nonNullMap(java.util.Map,java.lang.Class)">non­Null­Map</a>, <a href="../../ModifiableMetadata.html#nonNullSet(java.util.Set,java.lang.Class)">non­Null­Set</a>, <a href="../../ModifiableMetadata.html#singleton(E,java.lang.Class)">singleton</a>, <a href="../../ModifiableMetadata.html#state()">state</a>, <a href="../../ModifiableMetadata.html#unmodifiable()">unmodifiable</a>, <a href="../../ModifiableMetadata.html#writeCollection(java.util.Collection,java.util.Collection,java.lang.Class)">write­Collection</a>, <a href="../../ModifiableMetadata.html#writeList(java.util.Collection,java.util.List,java.lang.Class)">write­List</a>, <a href="../../ModifiableMetadata.html#writeMap(java.util.Map,java.util.Map,java.lang.Class)">write­Map</a>, <a href="../../ModifiableMetadata.html#writeSet(java.util.Collection,java.util.Set,java.lang.Class)">write­Set</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a id="methods.inherited.from.class.AbstractMetadata">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;<a href="../../AbstractMetadata.html" title="class in org.apache.sis.metadata">AbstractMetadata</a></h3>
<code><a href="../../AbstractMetadata.html#asMap()">as­Map</a>, <a href="../../AbstractMetadata.html#asTreeTable()">as­Tree­Table</a>, <a href="../../AbstractMetadata.html#equals(java.lang.Object)">equals</a>, <a href="../../AbstractMetadata.html#equals(java.lang.Object,org.apache.sis.util.ComparisonMode)">equals</a>, <a href="../../AbstractMetadata.html#getInterface()">get­Interface</a>, <a href="../../AbstractMetadata.html#hashCode()">hash­Code</a>, <a href="../../AbstractMetadata.html#isEmpty()">is­Empty</a>, <a href="../../AbstractMetadata.html#prune()">prune</a>, <a href="../../AbstractMetadata.html#toString()">to­String</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a id="methods.inherited.from.class.Object">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang" class="externalLink">Object</a></h3>
<code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang" class="externalLink">clone</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang" class="externalLink">finalize</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang" class="externalLink">get­Class</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang" class="externalLink">notify</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang" class="externalLink">notify­All</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang" class="externalLink">wait</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang" class="externalLink">wait</a>, <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait(long,int)" title="class or interface in java.lang" class="externalLink">wait</a></code></li>
</ul>
</li>
</ul>
</section>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<section role="region">
<ul class="blockList">
<li class="blockList"><a id="constructor.detail">
<!-- -->
</a>
<h3>Constructor Detail</h3>
<a id="&lt;init&gt;()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>DefaultResolution</h4>
<pre>public&nbsp;DefaultResolution()</pre>
<div class="block">Constructs an initially empty resolution.</div>
</li>
</ul>
<a id="&lt;init&gt;(org.opengis.metadata.identification.RepresentativeFraction)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>DefaultResolution</h4>
<pre>public&nbsp;DefaultResolution&#8203;(<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/metadata/identification/RepresentativeFraction.html?is-external=true" title="class or interface in org.opengis.metadata.identification" class="externalLink">RepresentativeFraction</a>&nbsp;scale)</pre>
<div class="block">Creates a new resolution initialized to the given scale.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>scale</code> - the scale, or <code>null</code> if none.</dd>
<dt><span class="simpleTagLabel">Since:</span></dt>
<dd>0.4</dd>
</dl>
</li>
</ul>
<a id="&lt;init&gt;(org.opengis.metadata.identification.Resolution)">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>DefaultResolution</h4>
<pre>public&nbsp;DefaultResolution&#8203;(<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/metadata/identification/Resolution.html?is-external=true" title="class or interface in org.opengis.metadata.identification" class="externalLink">Resolution</a>&nbsp;object)</pre>
<div class="block">Constructs a new instance initialized with the values from the specified metadata object.
This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the
given object are not recursively copied.
<p>If more than one of the <a href="#getEquivalentScale()">equivalent scale</a>,
<a href="#getDistance()">distance</a>, <a href="#getVertical()">vertical</a>,
<a href="#getAngularDistance()">angular distance</a> and <a href="#getLevelOfDetail()">level of detail</a>
are specified, then the first of those values is taken and the other values are silently discarded.</p>
<div class="note"><b>Note on properties validation:</b>
This constructor does not verify the property values of the given metadata (e.g. whether it contains
unexpected negative values). This is because invalid metadata exist in practice, and verifying their
validity in this copy constructor is often too late. Note that this is not the only hole, as invalid
metadata instances can also be obtained by unmarshalling an invalid XML document.
</div></div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>object</code> - the metadata to copy values from, or <code>null</code> if none.</dd>
<dt><span class="seeLabel">See Also:</span></dt>
<dd><a href="#castOrCopy(org.opengis.metadata.identification.Resolution)"><code>cast­Or­Copy(Resolution)</code></a></dd>
</dl>
</li>
</ul>
</li>
</ul>
</section>
<!-- ============ METHOD DETAIL ========== -->
<section role="region">
<ul class="blockList">
<li class="blockList"><a id="method.detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a id="castOrCopy(org.opengis.metadata.identification.Resolution)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>castOrCopy</h4>
<pre class="methodSignature">public static&nbsp;<a href="DefaultResolution.html" title="class in org.apache.sis.metadata.iso.identification">DefaultResolution</a>&nbsp;castOrCopy&#8203;(<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/metadata/identification/Resolution.html?is-external=true" title="class or interface in org.opengis.metadata.identification" class="externalLink">Resolution</a>&nbsp;object)</pre>
<div class="block">Returns a SIS metadata implementation with the values of the given arbitrary implementation.
This method performs the first applicable action in the following choices:
<ul>
<li>If the given object is <code>null</code>, then this method returns <code>null</code>.</li>
<li>Otherwise if the given object is already an instance of
<code>Default­Resolution</code>, then it is returned unchanged.</li>
<li>Otherwise a new <code>Default­Resolution</code> instance is created using the
<a href="#%3Cinit%3E(org.opengis.metadata.identification.Resolution)">copy constructor</a>
and returned. Note that this is a <cite>shallow</cite> copy operation, since the other
metadata contained in the given object are not recursively copied.</li>
</ul></div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>object</code> - the object to get as a SIS implementation, or <code>null</code> if none.</dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>a SIS implementation containing the values of the given object (may be the
given object itself), or <code>null</code> if the argument was null.</dd>
</dl>
</li>
</ul>
<a id="getEquivalentScale()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getEquivalentScale</h4>
<pre class="methodSignature">public&nbsp;<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/metadata/identification/RepresentativeFraction.html?is-external=true" title="class or interface in org.opengis.metadata.identification" class="externalLink">RepresentativeFraction</a>&nbsp;getEquivalentScale()</pre>
<div class="block">Returns the level of detail expressed as the scale of a comparable hardcopy map or chart.</div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="http://www.geoapi.org/3.0/javadoc/org/opengis/metadata/identification/Resolution.html?is-external=true#getEquivalentScale()" title="class or interface in org.opengis.metadata.identification" class="externalLink">get­Equivalent­Scale</a></code>&nbsp;in interface&nbsp;<code><a href="http://www.geoapi.org/3.0/javadoc/org/opengis/metadata/identification/Resolution.html?is-external=true" title="class or interface in org.opengis.metadata.identification" class="externalLink">Resolution</a></code></dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>level of detail expressed as the scale of a comparable hardcopy, or <code>null</code>.</dd>
</dl>
</li>
</ul>
<a id="setEquivalentScale(org.opengis.metadata.identification.RepresentativeFraction)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setEquivalentScale</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;setEquivalentScale&#8203;(<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/metadata/identification/RepresentativeFraction.html?is-external=true" title="class or interface in org.opengis.metadata.identification" class="externalLink">RepresentativeFraction</a>&nbsp;newValue)</pre>
<div class="block">Sets the level of detail expressed as the scale of a comparable hardcopy map or chart.
<div class="section">Effect on other properties</div>
If and only if the <code>new­Value</code> is non-null, then this method automatically
discards all other properties.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>new­Value</code> - the new equivalent scale.</dd>
</dl>
</li>
</ul>
<a id="getDistance()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getDistance</h4>
<pre class="methodSignature"><a href="../../../measure/ValueRange.html" title="annotation in org.apache.sis.measure">@ValueRange</a>(<a href="../../../measure/ValueRange.html#minimum()">minimum</a>=0.0,
<a href="../../../measure/ValueRange.html#isMinIncluded()">isMinIncluded</a>=false)
public&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang" class="externalLink">Double</a>&nbsp;getDistance()</pre>
<div class="block">Returns the ground sample distance.</div>
<dl>
<dt><span class="overrideSpecifyLabel">Specified by:</span></dt>
<dd><code><a href="http://www.geoapi.org/3.0/javadoc/org/opengis/metadata/identification/Resolution.html?is-external=true#getDistance()" title="class or interface in org.opengis.metadata.identification" class="externalLink">get­Distance</a></code>&nbsp;in interface&nbsp;<code><a href="http://www.geoapi.org/3.0/javadoc/org/opengis/metadata/identification/Resolution.html?is-external=true" title="class or interface in org.opengis.metadata.identification" class="externalLink">Resolution</a></code></dd>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the ground sample distance, or <code>null</code>.</dd>
</dl>
</li>
</ul>
<a id="setDistance(java.lang.Double)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setDistance</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;setDistance&#8203;(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang" class="externalLink">Double</a>&nbsp;newValue)</pre>
<div class="block">Sets the ground sample distance.
<div class="section">Effect on other properties</div>
If and only if the <code>new­Value</code> is non-null, then this method automatically
discards all other properties.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>new­Value</code> - the new distance, or <code>null</code>.</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang" class="externalLink">Illegal­Argument­Exception</a></code> - if the given value is NaN, zero or negative.</dd>
</dl>
</li>
</ul>
<a id="getVertical()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getVertical</h4>
<pre class="methodSignature"><a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/UML.html?is-external=true" title="class or interface in org.opengis.annotation" class="externalLink">@UML</a>(<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/UML.html?is-external=true#identifier()" title="class or interface in org.opengis.annotation" class="externalLink">identifier</a>="vertical",
<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/UML.html?is-external=true#obligation()" title="class or interface in org.opengis.annotation" class="externalLink">obligation</a>=<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/Obligation.html?is-external=true#CONDITIONAL" title="class or interface in org.opengis.annotation" class="externalLink">CONDITIONAL</a>,
<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/UML.html?is-external=true#specification()" title="class or interface in org.opengis.annotation" class="externalLink">specification</a>=<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/Specification.html?is-external=true#ISO_19115" title="class or interface in org.opengis.annotation" class="externalLink">ISO_19115</a>)
<a href="../../../measure/ValueRange.html" title="annotation in org.apache.sis.measure">@ValueRange</a>(<a href="../../../measure/ValueRange.html#minimum()">minimum</a>=0.0,
<a href="../../../measure/ValueRange.html#isMinIncluded()">isMinIncluded</a>=false)
public&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang" class="externalLink">Double</a>&nbsp;getVertical()</pre>
<div class="block">Returns the vertical sampling distance.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the vertical sampling distance, or <code>null</code>.</dd>
<dt><span class="simpleTagLabel">Since:</span></dt>
<dd>0.5</dd>
</dl>
</li>
</ul>
<a id="setVertical(java.lang.Double)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setVertical</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;setVertical&#8203;(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang" class="externalLink">Double</a>&nbsp;newValue)</pre>
<div class="block">Sets the vertical sampling distance.
<div class="section">Effect on other properties</div>
If and only if the <code>new­Value</code> is non-null, then this method automatically
discards all other properties.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>new­Value</code> - the new distance, or <code>null</code>.</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang" class="externalLink">Illegal­Argument­Exception</a></code> - if the given value is NaN, zero or negative.</dd>
<dt><span class="simpleTagLabel">Since:</span></dt>
<dd>0.5</dd>
</dl>
</li>
</ul>
<a id="getAngularDistance()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getAngularDistance</h4>
<pre class="methodSignature"><a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/UML.html?is-external=true" title="class or interface in org.opengis.annotation" class="externalLink">@UML</a>(<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/UML.html?is-external=true#identifier()" title="class or interface in org.opengis.annotation" class="externalLink">identifier</a>="angularDistance",
<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/UML.html?is-external=true#obligation()" title="class or interface in org.opengis.annotation" class="externalLink">obligation</a>=<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/Obligation.html?is-external=true#CONDITIONAL" title="class or interface in org.opengis.annotation" class="externalLink">CONDITIONAL</a>,
<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/UML.html?is-external=true#specification()" title="class or interface in org.opengis.annotation" class="externalLink">specification</a>=<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/Specification.html?is-external=true#ISO_19115" title="class or interface in org.opengis.annotation" class="externalLink">ISO_19115</a>)
<a href="../../../measure/ValueRange.html" title="annotation in org.apache.sis.measure">@ValueRange</a>(<a href="../../../measure/ValueRange.html#minimum()">minimum</a>=0.0,
<a href="../../../measure/ValueRange.html#isMinIncluded()">isMinIncluded</a>=false)
public&nbsp;<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang" class="externalLink">Double</a>&nbsp;getAngularDistance()</pre>
<div class="block">Returns the angular sampling measure.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>the angular sampling measure, or <code>null</code>.</dd>
<dt><span class="simpleTagLabel">Since:</span></dt>
<dd>0.5</dd>
</dl>
</li>
</ul>
<a id="setAngularDistance(java.lang.Double)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>setAngularDistance</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;setAngularDistance&#8203;(<a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Double.html?is-external=true" title="class or interface in java.lang" class="externalLink">Double</a>&nbsp;newValue)</pre>
<div class="block">Sets the angular sampling measure.
<div class="section">Effect on other properties</div>
If and only if the <code>new­Value</code> is non-null, then this method automatically
discards all other properties.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>new­Value</code> - the new distance, or <code>null</code>.</dd>
<dt><span class="throwsLabel">Throws:</span></dt>
<dd><code><a href="https://docs.oracle.com/javase/8/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang" class="externalLink">Illegal­Argument­Exception</a></code> - if the given value is NaN, zero or negative.</dd>
<dt><span class="simpleTagLabel">Since:</span></dt>
<dd>0.5</dd>
</dl>
</li>
</ul>
<a id="getLevelOfDetail()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getLevelOfDetail</h4>
<pre class="methodSignature"><a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/UML.html?is-external=true" title="class or interface in org.opengis.annotation" class="externalLink">@UML</a>(<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/UML.html?is-external=true#identifier()" title="class or interface in org.opengis.annotation" class="externalLink">identifier</a>="levelOfDetail",
<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/UML.html?is-external=true#obligation()" title="class or interface in org.opengis.annotation" class="externalLink">obligation</a>=<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/Obligation.html?is-external=true#CONDITIONAL" title="class or interface in org.opengis.annotation" class="externalLink">CONDITIONAL</a>,
<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/UML.html?is-external=true#specification()" title="class or interface in org.opengis.annotation" class="externalLink">specification</a>=<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/annotation/Specification.html?is-external=true#ISO_19115" title="class or interface in org.opengis.annotation" class="externalLink">ISO_19115</a>)
public&nbsp;<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/util/InternationalString.html?is-external=true" title="class or interface in org.opengis.util" class="externalLink">InternationalString</a>&nbsp;getLevelOfDetail()</pre>
<div class="block">Returns a brief textual description of the spatial resolution of the resource.</div>
<dl>
<dt><span class="returnLabel">Returns:</span></dt>
<dd>textual description of the spatial resolution, or <code>null</code>.</dd>
<dt><span class="simpleTagLabel">Since:</span></dt>
<dd>0.5</dd>
</dl>
</li>
</ul>
<a id="setLevelOfDetail(org.opengis.util.InternationalString)">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>setLevelOfDetail</h4>
<pre class="methodSignature">public&nbsp;void&nbsp;setLevelOfDetail&#8203;(<a href="http://www.geoapi.org/3.0/javadoc/org/opengis/util/InternationalString.html?is-external=true" title="class or interface in org.opengis.util" class="externalLink">InternationalString</a>&nbsp;newValue)</pre>
<div class="block">Sets the textual description of the spatial resolution of the resource.
<div class="section">Effect on other properties</div>
If and only if the <code>new­Value</code> is non-null, then this method automatically
discards all other properties.</div>
<dl>
<dt><span class="paramLabel">Parameters:</span></dt>
<dd><code>new­Value</code> - the new distance.</dd>
<dt><span class="simpleTagLabel">Since:</span></dt>
<dd>0.5</dd>
</dl>
</li>
</ul>
</li>
</ul>
</section>
</li>
</ul>
</div>
</div>
</main>
<!-- ========= END OF CLASS DATA ========= -->
<footer role="contentinfo">
<nav role="navigation">
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a id="navbar.bottom">
<!-- -->
</a>
<div class="skipNav"><a href="#skip.navbar.bottom" title="Skip navigation links">Skip navigation links</a></div>
<a id="navbar.bottom.firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../../../index.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/DefaultResolution.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../../../index-all.html">Index</a></li>
<li><a href="../../../../../../help-doc.html">Help</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../../../../allclasses.html">All&nbsp;Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_bottom");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li><a href="#nested.class.summary">Nested</a>&nbsp;|&nbsp;</li>
<li><a href="#field.summary">Field</a>&nbsp;|&nbsp;</li>
<li><a href="#constructor.summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li>Field&nbsp;|&nbsp;</li>
<li><a href="#constructor.detail">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method.detail">Method</a></li>
</ul>
</div>
<a id="skip.navbar.bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
</nav>
<p class="legalCopy"><small>Copyright &#169; 2010&#x2013;2019 <a href="https://www.apache.org/">The Apache Software Foundation</a>. All rights reserved.</small></p>
</footer>
</body>
</html>