Summary
Updates the reference scale of an existing annotation feature class.
Usage
Before an annotation feature class can have its reference scale updated, it must be upgraded to the current release using the Upgrade Dataset tool.
Versioned annotation feature classes cannot have their reference scale updated.
Changing the reference scale of an annotation feature class is an intensive operation that requires an update of every feature's bounding box geometry.
An ArcGIS Desktop Standard or ArcGIS Desktop Advanced license is required to update the reference scale of a feature-linked annotation feature class.
Caution:
This tool modifies the input data. See Tools that do not create output datasets for more information and strategies to avoid undesired data changes.
Syntax
UpdateAnnotationReferenceScale_cartography (in_anno_features, reference_scale)
Parameter | Explanation | Data Type |
in_anno_features | The input annotation features. | Annotation Layer |
reference_scale | The annotation feature class reference scale to be updated. | Double |
Derived Output
Name | Explanation | Data Type |
updated_annotation | The updated annotation. | Annotation Layer |
Code sample
The following Python window script demonstrates how to use the UpdateAnnotationReferenceScale tool in immediate mode.
import arcpy
arcpy.cartography.UpdateAnnotationReferenceScale("C:/data/Canada.gdb/cities",
4000000)
Environments
Licensing information
- Basic: Yes
- Standard: Yes
- Advanced: Yes