Changes between Version 16 and Version 17 of FDORfc60

Timestamp:

04/13/11 09:13:39 (14 years ago)

Author:

gregboone

Comment:

--

FDORfc60

@@ -521 +521 @@
 }}}
 
+==== Inserting and Updating Features with Annotation Properties ====
+
+Annotation Text associated to FDO features will be insertable and updatable through a extended set of derived FDO interfaces that follow the existing !PropertyValue pattern used to specify data values for the FdoIInsert and FdoIUpadte comands. The newly defined Annotation interfaces will be derived from FdoExpression and FdoValueExpression and allow the Annotation properties to be set as Property Values and be parsed as expressions. 
+
+The first step required to support an insertable Annotation is to derive a new !FdoAnnotationValue class from !FdoValueExpression. Instances of !FdoAnnotationValue will be set as the Value object on !FdoPropertyValue. Users of !AnnotationValue will have the ability to specify the Annotation Envelope and set of !TextElementValues attached to the Annotation.
+
+{{{
+class FdoAnnotationValue : public FdoValueExpression
+{
+public:
+    FdoGeometryValue* Envelope;
+    FdoStringValue* DefaultTextValue;
+    FdoStringValue* DefaultTextAttributesValue;
+    FdoAnnotationTextElementValueCollection* TextElementValues; 
+
+public:
+    bool IsNull();
+    void SetNullValue();
+    void Process(FdoIExpressionProcessor* p);
+    FdoString* ToString();
+    FdoExpressionItemType GetExpressionType();
+};
+}}}
+
+While the above class allows users to specify high level Annotation values, they will still need a secondary Expression interface to specify the order list of !TextElementValues attached to the Annotation. Through this interface, users will be able to specify the Annotation Text location, leader line, text value, and attributes.
+
+{{{
+class FdoAnnotationTextElementValue : public FdoExpression
+{
+public:
+    FdoGeometryValue* Location;
+    FdoGeometryValue* LeaderLine;
+    FdoStringValue* TextValue;
+    FdoStringValue* TextAttributesValue;
+
+public:
+    void Process(FdoIExpressionProcessor* p);
+    FdoString* ToString();
+    FdoExpressionItemType GetExpressionType();
+};
+}}}
+
+===== Inserting Features with Annotation Properties =====
+
+Using the above Road/!RoadAnnotation Example, here is an example of how Annotation properties would be inserted into an FDO data store as a part of a feature.
+
+
+{{{
+// Create an Insert command to create a Road
+FdoPtr<FdoIInsert> insCmd = (FdoIInsert*)(conn->CreateCommand(FdoCommandType_Insert));
+insCmd->SetFeatureClassName(L"Road");
+FdoPtr<FdoPropertyValueCollection> propVals = insCmd->GetPropertyValues();
+
+// Specify Road object's Geometry as a line string
+FdoPtr<FdoDirectPositionCollection> objPoints = FdoDirectPositionCollection::Create();
+FdoPtr<FdoIDirectPosition> pt1 = gf->CreatePositionXY(pt_A.x, pt_A.y); 
+FdoPtr<FdoIDirectPosition> pt2 = gf->CreatePositionXY(pt_C.x, pt_B.y);
+FdoPtr<FdoIDirectPosition> pt3 = gf->CreatePositionXY(pt_C.x, pt_C.y);
+objPoints->Add(pt1);
+objPoints->Add(pt2);
+objPoints->Add(pt3);
+FdoPtr<FdoILineStringSegment> lineSeg = gf->CreateLineStringSegment(objPoints);
+FdoPtr<FdoByteArray> fgf = gf->GetFgf(lineSeg);
+FdoPtr<FdoGeometryValue> gv = FdoGeometryValue::Create(fgf);
+FdoPtr<FdoPropertyValue> propGeom = FdoPropertyValue::Create(L"Geometry", gv);
+propVals->Add(propGeom);
+
+
+// Specify Road object's Name
+FdoPtr<FdoStringValue> strValue = FdoStringValue::Create(L"Main St.");
+FdoPtr<FdoPropertyValue> propName = FdoPropertyValue::Create(L"Name", strValue);
+propVals->Add(propName);
+
+// Specify Road object's Width
+FdoPtr<FdoInt32Value> width = FdoInt64Value::Create(20);
+FdoPtr<FdoPropertyValue> propWidth = FdoPropertyValue::Create(L"Width", width);
+propVals->Add(propWidth);
+
+// Create a Text Annotation Location as a point in space
+double* ordsXY = new double[2];
+ordsXY[0] = pt_D.x; ordsXY[1] = pt_D.y;
+FdoPtr<FdoIGeometry> pnt = gf->CreatePoint(FdoDimensionality_XY, ordsXY);
+FdoPtr<FdoByteArray> fgf2 = gf->GetFgf(pnt);
+FdoPtr<FdoGeometryValue> gv2 = FdoGeometryValue::Create(fgf2);
+
+// Create a Text Annotation Leader Line as a 2 segment line
+FdoPtr<FdoDirectPositionCollection> leaderPoints = FdoDirectPositionCollection::Create();
+FdoPtr<FdoIDirectPosition> pt4 = gf->CreatePositionXY(pt_E.x, pt_E.y); 
+FdoPtr<FdoIDirectPosition> pt5 = gf->CreatePositionXY(pt_F.x, pt_F.y);
+FdoPtr<FdoIDirectPosition> pt6 = gf->CreatePositionXY(pt_G.x, pt_G.y);
+leaderPoints->Add(pt4);
+leaderPoints->Add(pt5);
+leaderPoints->Add(pt6);
+FdoPtr<FdoILineStringSegment> lineSeg2 = gf->CreateLineStringSegment(leaderPoints);
+FdoPtr<FdoByteArray> fgf3 = gf->GetFgf(lineSeg2);
+FdoPtr<FdoGeometryValue> gv3 = FdoGeometryValue::Create(fgf3);
+
+// Define the Annotation Text Envelope as a simple bounding box
+FdoPtr<FdoIEnvelope> envl = gf->CreateEnvelopeXY(pt_H.x, pt_H.y, pt_J.x, pt_J.y);
+FdoPtr<FdoByteArray> fgf4 = gf->GetFgf(envl);
+FdoPtr<FdoGeometryValue> gv4 = FdoGeometryValue::Create(fgf4);
+
+// Specify the Annotation Text as an expression. Value determined at runtime
+FdoPtr<FdoStringValue> textStrValue = FdoStringValue::Create(L"Road.Name");
+
+// Specify the Annotation Text as an expression (NULL)
+FdoPtr<FdoStringValue> textAttribValue = FdoStringValue::Create(L"");
+textAttribValue->SetNull();
+
+// Create the Text Element Values (only one here) associated to the annotation 
+FdoPtr<FdoAnnotationTextElementValue> eValue = FdoAnnotationTextElementValue::Create();
+eValue->SetLocation(gv2);
+eValue->SetLeaderLine(gv3);
+eValue->SetTextValue(textStrValue);
+eValue->SetTextAttributesValue(textAttribValue);
+
+// Create the Annotation Value and set the Envelope and text elements
+FdoPtr<FdoAnnotationValue> annValue = FdoAnnotationValue::Create();
+annValue->SetEnvelope(gv4);
+FdoAnnotationTextElementValueCollectionP textElements = annValue->GetTextElementValues();
+textElements->Add(eValue);
+FdoPtr<FdoPropertyValue> propAnn = FdoPropertyValue::Create(L"Annotation", annValue);
+propVals->Add(propAnn);
+
+// Execute the insert
+FdoPtr<FdoIFeatureReader> rdr = insCmd->Execute();
+}}}
+
+===== Updating Features with Annotation Properties =====
+
+Using the above Road/!RoadAnnotation Example, here is an example of how Annotation properties would be updated in an FDO data store as a part of a feature edit.
+
+
+{{{
+// Create an Update command to create a Road
+FdoPtr<FdoIUpdate> cmd = (FdoIUpdate*)(conn->CreateCommand(FdoCommandType_Insert));
+cmd->SetFeatureClassName(L"Road");
+FdoPtr<FdoPropertyValueCollection> propVals = cmd->GetPropertyValues();
+
+// Specify the Filter
+FdoPtr<FdoFilter> filter = FdoFilter::Parse(L"FeatId=100");
+cmd->SetFilter(filter);
+
+// Create a Text Annotation Location as a point in space
+double* ordsXY = new double[2];
+ordsXY[0] = pt_D.x; ordsXY[1] = pt_D.y;
+FdoPtr<FdoIGeometry> pnt = gf->CreatePoint(FdoDimensionality_XY, ordsXY);
+FdoPtr<FdoByteArray> fgf2 = gf->GetFgf(pnt);
+FdoPtr<FdoGeometryValue> gv2 = FdoGeometryValue::Create(fgf2);
+
+// Create a Text Annotation Leader Line as a 2 segment line
+FdoPtr<FdoDirectPositionCollection> ldrPts = FdoDirectPositionCollection::Create();
+FdoPtr<FdoIDirectPosition> pt4 = gf->CreatePositionXY(pt_E.x, pt_E.y); 
+FdoPtr<FdoIDirectPosition> pt5 = gf->CreatePositionXY(pt_F.x, pt_F.y);
+FdoPtr<FdoIDirectPosition> pt6 = gf->CreatePositionXY(pt_G.x, pt_G.y);
+ldrPts->Add(pt4);
+ldrPts->Add(pt5);
+ldrPts->Add(pt6);
+FdoPtr<FdoILineStringSegment> lineSeg2 = gf->CreateLineStringSegment(ldrPts);
+FdoPtr<FdoByteArray> fgf3 = gf->GetFgf(lineSeg2);
+FdoPtr<FdoGeometryValue> gv3 = FdoGeometryValue::Create(fgf3);
+
+// Define the Annotation Text Envelope as a simple bounding box
+FdoPtr<FdoIEnvelope> envl = gf->CreateEnvelopeXY(pt_H.x, pt_H.y, pt_J.x, pt_J.y);
+FdoPtr<FdoByteArray> fgf4 = gf->GetFgf(envl);
+FdoPtr<FdoGeometryValue> gv4 = FdoGeometryValue::Create(fgf4);
+
+// Specify the Annotation Text as an expression. Value determined at runtime
+FdoPtr<FdoStringValue> textStrValue = FdoStringValue::Create(L"Main St.");
+
+// Specify the Annotation Text as an expression (NULL)
+FdoStringP textAttributes = GetTextAttributesAsXMLDocument();
+FdoPtr<FdoStringValue> textAttribValue = FdoStringValue::Create(textAttributes);
+
+// Create the Text Element Values (only one here) associated to the annotation 
+FdoAnnotationTextElementValueP txtElemVal = FdoAnnotationTextElementValue::Create();
+txtElemVal->SetLocation(gv2);
+txtElemVal->SetLeaderLine(gv3);
+txtElemVal->SetTextValue(textStrValue);
+txtElemVal->SetTextAttributesValue(textAttribValue);
+
+// Create the Annotation Value and set the Envelope and text elements
+FdoPtr<FdoAnnotationValue> annotationValue = FdoAnnotationValue::Create();
+annotationValue->SetEnvelope(gv4);
+FdoAnnotationTextElementValueCollectionP txtElems = annValue->GetTextElementValues();
+textElements->Add(textElementValue);
+FdoPtr<FdoPropertyValue> propAnn = FdoPropertyValue::Create(L"Annotation", annValue);
+propVals->Add(propAnn);
+
+// Execute the update
+FdoPtr<FdoITransaction> tr = conn->BeginTransaction();
+FdoInt32 rez = cmd->Execute();
+tr->Commit();
+}}}