func UserAgent() string
UserAgent returns the UserAgent string to use when sending http.Requests.
func Version() string
Version returns the semantic version (see http://semver.org) of the client.
AlternatePatternItem ...
type AlternatePatternItem struct {
// Category - Possible values include: 'LeafInkDrawing', 'LeafInkBullet', 'LeafInkWord', 'LeafUnknown'
Category Leaf `json:"category,omitempty"`
// Points - Array of point objects that represent points that are relevant to the type of recognition unit. For example, for leaf node of inkDrawing category that represents a triangle, points would include the x,y coordinates of the vertices of the recognized triangle. The points represent the coordinates of points used to create the perfectly drawn shape that is closest to the original input. They may not exactly match.
Points *[]PointDetailsPattern `json:"points,omitempty"`
// RotationAngle - The angular orientation of an object relative to the horizontal axis
RotationAngle *float64 `json:"rotationAngle,omitempty"`
// Confidence - A number between 0 and 1 which indicates the confidence level in the result
Confidence *float64 `json:"confidence,omitempty"`
// RecognizedString - The recognized string from an inkWord or the name of a recognized shape in an inkDrawing object
RecognizedString *string `json:"recognizedString,omitempty"`
}
AnalysisRequest this shows the expected contents of a request
type AnalysisRequest struct {
// ApplicationType - This describes the domain of the client application. Possible values include: 'Drawing', 'Writing', 'Mixed'
ApplicationType Application `json:"applicationType,omitempty"`
// InputDeviceKind - This identifies the kind of device used as the writing instrument. Possible values include: 'Digitizer', 'Pen', 'LightPen', 'TouchScreen', 'TouchPad', 'WhiteBoard', 'ThreedDigitizer', 'StereoPlotter', 'ArticulatedArm', 'Armature'
InputDeviceKind InputDevice `json:"inputDeviceKind,omitempty"`
// Unit - This is the physical unit of the ink strokes. It is up to the application developer to decide how to convert the device specific units to physical units before calling the service. The conversion factor can be different based on the type of the device used. Possible values include: 'Mm', 'Cm', 'In'
Unit Unit `json:"unit,omitempty"`
// UnitMultiple - This is a scaling factor to be applied to the point coordinates when interpreting them in the physical units specified.
UnitMultiple *float64 `json:"unitMultiple,omitempty"`
// Language - The IETF BCP 47 language code (for ex. en-US, en-GB, hi-IN etc.) of the expected language for the handwritten content in the ink strokes. The response will include results from this language.
Language *string `json:"language,omitempty"`
InkPointValueAttributes *[]InkPointValueAttribute `json:"inkPointValueAttributes,omitempty"`
// Strokes - This is the array of strokes sent for recognition. Best results are produced when the order of strokes added in the array matches the order in which the user created them. Changing the stroke order may produce unexpected results.
Strokes *[]Stroke `json:"strokes,omitempty"`
}
AnalysisResponse this shows the expected contents of a response from the service
type AnalysisResponse struct {
autorest.Response `json:"-"`
// Unit - This is the physical unit of the ink strokes. It is up to the application developer to decide how to convert the device specific units to physical units before calling the service. The conversion factor can be different based on the type of the device used. Possible values include: 'Mm', 'Cm', 'In'
Unit Unit `json:"unit,omitempty"`
// UnitMultiple - This is a scaling factor to be applied to the point coordinates when interpreting them in the physical units specified.
UnitMultiple *float64 `json:"unitMultiple,omitempty"`
// Language - This is the language used for recognizing handwriting from the ink strokes in the request.
Language *string `json:"language,omitempty"`
RecognitionUnits *[]RecognitionUnitItem `json:"recognitionUnits,omitempty"`
}
Application enumerates the values for application.
type Application string
const (
// Drawing ...
Drawing Application = "drawing"
// Mixed ...
Mixed Application = "mixed"
// Writing ...
Writing Application = "writing"
)
func PossibleApplicationValues() []Application
PossibleApplicationValues returns an array of possible values for the Application const type.
BaseClient is the base client for Inkrecognizer.
type BaseClient struct {
autorest.Client
Endpoint string
}
func New(endpoint string) BaseClient
New creates an instance of the BaseClient client.
func NewWithoutDefaults(endpoint string) BaseClient
NewWithoutDefaults creates an instance of the BaseClient client.
Category enumerates the values for category.
type Category string
const (
// InkBullet ...
InkBullet Category = "inkBullet"
// InkDrawing ...
InkDrawing Category = "inkDrawing"
// InkWord ...
InkWord Category = "inkWord"
// Line ...
Line Category = "line"
// Paragraph ...
Paragraph Category = "paragraph"
// Root ...
Root Category = "root"
// Unknown ...
Unknown Category = "unknown"
// WritingRegion ...
WritingRegion Category = "writingRegion"
)
func PossibleCategoryValues() []Category
PossibleCategoryValues returns an array of possible values for the Category const type.
Class enumerates the values for class.
type Class string
const (
// ClassContainer ...
ClassContainer Class = "container"
// ClassLeaf ...
ClassLeaf Class = "leaf"
)
func PossibleClassValues() []Class
PossibleClassValues returns an array of possible values for the Class const type.
Client is the the service is used to perform ink layout and recognition of written words and shapes. Ink strokes passed to the service are recognized and organized into recognition results in the response
type Client struct {
BaseClient
}
func NewClient(endpoint string) Client
NewClient creates an instance of the Client client.
func (client Client) Recognize(ctx context.Context, body AnalysisRequest, xMsClientRequestID string) (result AnalysisResponse, err error)
Recognize ink Recognition operation is used to perform ink layout and recognition of written words and shapes. It allows passing the ink strokes to the service to get the recognition results in the response. Parameters: body - the collection of stroke objects to send for analysis xMsClientRequestID - the request id used to uniquely identify each request during troubleshooting. This is an optional parameter useful for correlating logs and other artifacts.
func (client Client) RecognizePreparer(ctx context.Context, body AnalysisRequest, xMsClientRequestID string) (*http.Request, error)
RecognizePreparer prepares the Recognize request.
func (client Client) RecognizeResponder(resp *http.Response) (result AnalysisResponse, err error)
RecognizeResponder handles the response to the Recognize request. The method always closes the http.Response Body.
func (client Client) RecognizeSender(req *http.Request) (*http.Response, error)
RecognizeSender sends the Recognize request. The method will close the http.Response Body if it receives an error.
Container enumerates the values for container.
type Container string
const (
// ContainerLine ...
ContainerLine Container = "line"
// ContainerParagraph ...
ContainerParagraph Container = "paragraph"
// ContainerRoot ...
ContainerRoot Container = "root"
// ContainerWritingRegion ...
ContainerWritingRegion Container = "writingRegion"
)
func PossibleContainerValues() []Container
PossibleContainerValues returns an array of possible values for the Container const type.
DrawingAttributesPattern the properties to use when rendering ink
type DrawingAttributesPattern struct {
// Width - The width of the stylus used to draw the stroke
Width *float64 `json:"width,omitempty"`
// Color - This shows the components of the color in rgba format
Color *DrawingAttributesPatternColor `json:"color,omitempty"`
// Height - The height of the stylus used to draw the stroke
Height *float64 `json:"height,omitempty"`
// FitToCurve - This indicates whether Bezier smoothing is used to render the stroke
FitToCurve *bool `json:"fitToCurve,omitempty"`
// RasterOp - Possible values include: 'NoOperation', 'CopyPen', 'MaskPen'
RasterOp RasterOp `json:"rasterOp,omitempty"`
// IgnorePressure - This indicates whether the thickness of a rendered Stroke changes according the amount of pressure applied.
IgnorePressure *bool `json:"ignorePressure,omitempty"`
// Tip - This specifies the tip to be used to draw a stroke. Possible values include: 'Ellipse', 'Rectangle'
Tip Tip `json:"tip,omitempty"`
}
DrawingAttributesPatternColor this shows the components of the color in rgba format
type DrawingAttributesPatternColor struct {
// R - The red component of the color
R *float64 `json:"r,omitempty"`
// G - The green component of the color
G *float64 `json:"g,omitempty"`
// B - The blue component of the color
B *float64 `json:"b,omitempty"`
// A - The alpha component of the color
A *float64 `json:"a,omitempty"`
}
ErrorModel ...
type ErrorModel struct {
// Code - This represents the error code
Code *string `json:"code,omitempty"`
// Message - This represents the error message
Message *string `json:"message,omitempty"`
// Target - This represents the target of the error message
Target *string `json:"target,omitempty"`
// Details - This gives details of the reason(s) for the error
Details *[]ErrorModelDetailsItem `json:"details,omitempty"`
}
ErrorModelDetailsItem ...
type ErrorModelDetailsItem struct {
// Code - This represents the error code
Code *string `json:"code,omitempty"`
// Message - This represents the error message
Message *string `json:"message,omitempty"`
// Target - This represents the target of the error message
Target *string `json:"target,omitempty"`
}
InkPoint an object containing the properties of an point in the path of an ink stroke. The main properties are the x and y values. Other include tip pressure, x tilt etc. For the coordinate values, it is recommended to have a precision of 8 digits after the decimal to obtain most accurate recognition results. The origin (0,0) of the canvas is assumed to be at the top left corner of the canvas
type InkPoint struct {
// X - The x coordinate of the pen location on the writing surface.
X *float64 `json:"x,omitempty"`
// Y - The y coordinate of the pen location on the writing surface.
Y *float64 `json:"y,omitempty"`
// Z - The z coordinate of the pen location on the writing space. This may not be used for recognition.
Z *float64 `json:"z,omitempty"`
// TipPressure - The force exerted against the tablet surface by the transducer, typically a stylus. This may not be used for recognition.
TipPressure *float64 `json:"tipPressure,omitempty"`
// BarrelPressure - The force exerted directly by the user on a transducer sensor, such as a pressure-sensitive button on the barrel of a stylus. This may not be used for recognition.
BarrelPressure *float64 `json:"barrelPressure,omitempty"`
// Timestamp - The time relative to the absolute time the transducer last became active. This may not be used for recognition.
Timestamp *float64 `json:"timestamp,omitempty"`
// XTilt - The plane angle between the Y-Z plane and the plane containing the transducer axis and the Y axis. This may not be used for recognition.
XTilt *float64 `json:"xTilt,omitempty"`
// YTilt - The angle between the X-Z and transducer-X planes. A positive Y Tilt is toward the user. This may not be used for recognition.
YTilt *float64 `json:"yTilt,omitempty"`
// Width - The width of the tip of the writing instrument. This is used by touch screen devices to report the width of the finger contact on the writing surface. This may not be used for recognition.
Width *float64 `json:"width,omitempty"`
// Height - The height of the tip of the writing instrument. This is used by touch screen devices to report the height of the finger contact on the writing surface. This may not be used for recognition.
Height *float64 `json:"height,omitempty"`
// TipSwitch - A switch located on the tip of a stylus indicating contact of the stylus with a surface. This may not be used for recognition.
TipSwitch *bool `json:"tipSwitch,omitempty"`
// Inverted - A value that indicates that the currently sensed position originates from the end of a stylus opposite the tip switch. This may not be used for recognition.
Inverted *bool `json:"inverted,omitempty"`
// BarrelSwitch - A non-tip button located on the barrel of a stylus. Its function is typically mapped to a system secondary button. This may not be used for recognition.
BarrelSwitch *bool `json:"barrelSwitch,omitempty"`
// Eraser - The control is used for erasing objects. It is typically located opposite the writing end of a stylus. This may not be used for recognition.
Eraser *bool `json:"eraser,omitempty"`
// SecondaryTip - A secondary switch used in conjunction with the tip switch to indicate pressure above a certain threshold applied with the stylus. This may not be used for recognition.
SecondaryTip *bool `json:"secondaryTip,omitempty"`
}
InkPointValueAttribute a container for the attributes of a value contained in the ink point object.
type InkPointValueAttribute struct {
// Name - The name of the point attribute.
Name *string `json:"name,omitempty"`
// LogicalMinimum - The minimum value for the attribute
LogicalMinimum *float64 `json:"logicalMinimum,omitempty"`
// LogicalMaximum - The maximum value for the attribute
LogicalMaximum *float64 `json:"logicalMaximum,omitempty"`
}
InputDevice enumerates the values for input device.
type InputDevice string
const (
// Armature ...
Armature InputDevice = "armature"
// ArticulatedArm ...
ArticulatedArm InputDevice = "articulatedArm"
// Digitizer ...
Digitizer InputDevice = "digitizer"
// LightPen ...
LightPen InputDevice = "lightPen"
// Pen ...
Pen InputDevice = "pen"
// StereoPlotter ...
StereoPlotter InputDevice = "stereoPlotter"
// ThreedDigitizer ...
ThreedDigitizer InputDevice = "3dDigitizer"
// TouchPad ...
TouchPad InputDevice = "touchPad"
// TouchScreen ...
TouchScreen InputDevice = "touchScreen"
// WhiteBoard ...
WhiteBoard InputDevice = "whiteBoard"
)
func PossibleInputDeviceValues() []InputDevice
PossibleInputDeviceValues returns an array of possible values for the InputDevice const type.
Kind enumerates the values for kind.
type Kind string
const (
// KindInkDrawing ...
KindInkDrawing Kind = "inkDrawing"
// KindInkWriting ...
KindInkWriting Kind = "inkWriting"
)
func PossibleKindValues() []Kind
PossibleKindValues returns an array of possible values for the Kind const type.
Leaf enumerates the values for leaf.
type Leaf string
const (
// LeafInkBullet ...
LeafInkBullet Leaf = "inkBullet"
// LeafInkDrawing ...
LeafInkDrawing Leaf = "inkDrawing"
// LeafInkWord ...
LeafInkWord Leaf = "inkWord"
// LeafUnknown ...
LeafUnknown Leaf = "unknown"
)
func PossibleLeafValues() []Leaf
PossibleLeafValues returns an array of possible values for the Leaf const type.
PointDetailsPattern this holds all the properties of one point
type PointDetailsPattern struct {
// X - This represents the x coordinate of the point
X *float64 `json:"x,omitempty"`
// Y - This represents the y coordinate of the point
Y *float64 `json:"y,omitempty"`
}
RasterOp enumerates the values for raster op.
type RasterOp string
const (
// CopyPen ...
CopyPen RasterOp = "copyPen"
// MaskPen ...
MaskPen RasterOp = "maskPen"
// NoOperation ...
NoOperation RasterOp = "noOperation"
)
func PossibleRasterOpValues() []RasterOp
PossibleRasterOpValues returns an array of possible values for the RasterOp const type.
RecognitionUnitItem this identifies the recognized entity
type RecognitionUnitItem struct {
// ID - The identifier of the recognition unit. This id is used to indicate parent/child relationship between different recognition units.
ID *int32 `json:"id,omitempty"`
// Category - Possible values include: 'Root', 'WritingRegion', 'Paragraph', 'Line', 'InkBullet', 'InkDrawing', 'InkWord', 'Unknown'
Category Category `json:"category,omitempty"`
Alternates *[]AlternatePatternItem `json:"alternates,omitempty"`
// Center - The coordinates (x,y) of the center of the recognition unit.
Center *PointDetailsPattern `json:"center,omitempty"`
// Points - Array of point objects that represent points that are relevant to the type of recognition unit. For example, for a leaf node of inkDrawing category that represents a triangle, points would include the x, y coordinates of the vertices of the recognized triangle. The points represent the coordinates used to create the perfectly drawn shape that is closest to the original input. They may not exactly match.
Points *[]PointDetailsPattern `json:"points,omitempty"`
// ChildIds - An array of integers representing the identifier of each child of the current recognition unit.
ChildIds *[]int32 `json:"childIds,omitempty"`
// Class - Possible values include: 'ClassContainer', 'ClassLeaf'
Class Class `json:"class,omitempty"`
// ParentID - The id of the parent node in the tree structure of the recognition results. parent = 0 indicates that there is no dedicated parent node for this unit.
ParentID *int32 `json:"parentId,omitempty"`
// BoundingRectangle - The bounding rectangle of the recognition unit represented by the coordinates of the top left corner (topX,topY) along with width and height of the rectangle. Note that this rectangle is not rotated. So for rotated objects such as slanted handwriting, it will cover the entire object. The unit will be matched to the one specified in the original request (mm by default.)
BoundingRectangle *RecognitionUnitItemBoundingRectangle `json:"boundingRectangle,omitempty"`
// RotatedBoundingRectangle - This is the rotated bounding rectangle that covers the entire recognized object along the angle of rotation of the object. Note that this is NOT the same as rotating the boundingRectangle by the rotation angle.
RotatedBoundingRectangle *[]PointDetailsPattern `json:"rotatedBoundingRectangle,omitempty"`
// StrokeIds - This is an array of integers representing the list of stroke Identifiers from the input request body that belong to this recognition unit.
StrokeIds *[]int32 `json:"strokeIds,omitempty"`
// RecognizedText - The string contains the text that was recognized. It can be an empty string if the recognizer cannot determine the text.
RecognizedText *string `json:"recognizedText,omitempty"`
// Confidence - A number between 0 and 1 which indicates the confidence level in the result.
Confidence *float64 `json:"confidence,omitempty"`
// RotationAngle - This is the angle at which the unit is rotated in degrees with respect to the positive X axis.
RotationAngle *float64 `json:"rotationAngle,omitempty"`
// RecognizedObject - Possible values include: 'ShapeDrawing', 'ShapeSquare', 'ShapeRectangle', 'ShapeCircle', 'ShapeEllipse', 'ShapeTriangle', 'ShapeIsoscelesTriangle', 'ShapeEquilateralTriangle', 'ShapeRightTriangle', 'ShapeQuadrilateral', 'ShapeDiamond', 'ShapeTrapezoid', 'ShapeParallelogram', 'ShapePentagon', 'ShapeHexagon', 'ShapeBlockArrow', 'ShapeHeart', 'ShapeStarSimple', 'ShapeStarCrossed', 'ShapeCloud', 'ShapeLine', 'ShapeCurve', 'ShapePolyLine'
RecognizedObject Shape `json:"recognizedObject,omitempty"`
}
RecognitionUnitItemBoundingRectangle the bounding rectangle of the recognition unit represented by the coordinates of the top left corner (topX,topY) along with width and height of the rectangle. Note that this rectangle is not rotated. So for rotated objects such as slanted handwriting, it will cover the entire object. The unit will be matched to the one specified in the original request (mm by default.)
type RecognitionUnitItemBoundingRectangle struct {
// TopX - This is the top left x coordinate
TopX *float64 `json:"topX,omitempty"`
// TopY - This is the top left y coordinate
TopY *float64 `json:"topY,omitempty"`
// Width - This is width of the bounding rectangle
Width *float64 `json:"width,omitempty"`
// Height - The is the height of the bounding rectangle
Height *float64 `json:"height,omitempty"`
}
Shape enumerates the values for shape.
type Shape string
const (
// ShapeBlockArrow ...
ShapeBlockArrow Shape = "blockArrow"
// ShapeCircle ...
ShapeCircle Shape = "circle"
// ShapeCloud ...
ShapeCloud Shape = "cloud"
// ShapeCurve ...
ShapeCurve Shape = "curve"
// ShapeDiamond ...
ShapeDiamond Shape = "diamond"
// ShapeDrawing ...
ShapeDrawing Shape = "drawing"
// ShapeEllipse ...
ShapeEllipse Shape = "ellipse"
// ShapeEquilateralTriangle ...
ShapeEquilateralTriangle Shape = "equilateralTriangle"
// ShapeHeart ...
ShapeHeart Shape = "heart"
// ShapeHexagon ...
ShapeHexagon Shape = "hexagon"
// ShapeIsoscelesTriangle ...
ShapeIsoscelesTriangle Shape = "isoscelesTriangle"
// ShapeLine ...
ShapeLine Shape = "line"
// ShapeParallelogram ...
ShapeParallelogram Shape = "parallelogram"
// ShapePentagon ...
ShapePentagon Shape = "pentagon"
// ShapePolyLine ...
ShapePolyLine Shape = "polyLine"
// ShapeQuadrilateral ...
ShapeQuadrilateral Shape = "quadrilateral"
// ShapeRectangle ...
ShapeRectangle Shape = "rectangle"
// ShapeRightTriangle ...
ShapeRightTriangle Shape = "rightTriangle"
// ShapeSquare ...
ShapeSquare Shape = "square"
// ShapeStarCrossed ...
ShapeStarCrossed Shape = "starCrossed"
// ShapeStarSimple ...
ShapeStarSimple Shape = "starSimple"
// ShapeTrapezoid ...
ShapeTrapezoid Shape = "trapezoid"
// ShapeTriangle ...
ShapeTriangle Shape = "triangle"
)
func PossibleShapeValues() []Shape
PossibleShapeValues returns an array of possible values for the Shape const type.
Stroke ...
type Stroke struct {
// ID - This is treated as a unique identifier for each stroke within a request. If the id is repeated within the same request, the service will return an error.
ID *int32 `json:"id,omitempty"`
// Language - The IETF BCP 47 language code (for ex. en-US, en-GB, hi-IN etc.) of the expected language for the handwritten content in this stroke. The response will include results from this language.
Language *string `json:"language,omitempty"`
Points *[]InkPoint `json:"points,omitempty"`
DrawingAttributes *DrawingAttributesPattern `json:"drawingAttributes,omitempty"`
// Kind - This is an optional property which influences the decision about what the stroke kind is between inkWriting and inkDrawing. This property should be set ONLY if the type of user content is known ahead of time. Not setting this value implies the kind is not known ahead of time. Kind represents the type of content the stroke is a part of. Possible values include: 'KindInkDrawing', 'KindInkWriting'
Kind Kind `json:"kind,omitempty"`
}
Tip enumerates the values for tip.
type Tip string
const (
// Ellipse ...
Ellipse Tip = "ellipse"
// Rectangle ...
Rectangle Tip = "rectangle"
)
func PossibleTipValues() []Tip
PossibleTipValues returns an array of possible values for the Tip const type.
Unit enumerates the values for unit.
type Unit string
const (
// Cm ...
Cm Unit = "cm"
// In ...
In Unit = "in"
// Mm ...
Mm Unit = "mm"
)
func PossibleUnitValues() []Unit
PossibleUnitValues returns an array of possible values for the Unit const type.
| Name | Synopsis |
|---|---|
| .. | |
| inkrecognizerapi | |