Difference: CDOverviewKeyConcepts (1 vs. 10)

Revision 102015-01-28 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="CDChartDirectorDesignerAPI"

Key Concepts

Line: 6 to 6
 

Description:

Changed:
<
<
The API's have been designed so that you have a minimum number of parameters to pass. They use the concept of the "current object", where Object can refer to a label, dataset, chart, etc. In other words, when adding data to a chart, you do not have to tell the API which chart you are adding it to, it will automatically add it to the "current" chart. Simiiarliy, when telling the API to render a chart, you do not have to tell it which chart, it will also automatically render the "current" chart. Or, when you create a label for your chart, the label just created will become the 'current' label and when you call other API routines to set the font, color or other attributes, it will automatically apply to that label. If you are working with more than one chart at a time, you can name each chart as you initialize it, and use an API to switch the current chart to one of the named charts. You can also name datasets, shapes and other objects. Normally you only need to do this if you are working with more than one of these at a time; otherwise, leaving the name blank will suffice.
>
>
The API's have been designed so that you have a minimum number of parameters to pass. They use the concept of the "current object", where Object can refer to a label, dataset, chart, etc. In other words, when adding data to a chart, you do not have to tell the API which chart you are adding it to, it will automatically add it to the "current" chart. Similarly, when telling the API to render a chart, you do not have to tell it which chart, it will also automatically render the "current" chart. Or, when you create a label for your chart, the label just created will become the 'current' label and when you call other API routines to set the font, color or other attributes, it will automatically apply to that label. If you are working with more than one chart at a time, you can name each chart as you initialize it, and use an API to switch the current chart to one of the named charts. You can also name datasets, shapes and other objects. Normally you only need to do this if you are working with more than one of these at a time; otherwise, leaving the name blank will suffice.
  The API's may have one or more required parameters and one or more optional parameters. If you fail to PASS a required parameter, the API will CANCEL with an error message indicating which parameter is missing. When PASSing optional parameters, you may have to PASS dummy parameters to fill in any gaps. For example, if an API takes 3 optional parameters, and you want to PASS a value to the second parameter, then you will have to PASS something for the first optional parameter, then the value you want for the second parameter. Otherwise, the API will associate your value with the first optional parameter, not the second.

Revision 92013-11-22 - AlKalter

Line: 1 to 1
 
META TOPICPARENT name="CDChartDirectorDesignerAPI"

Key Concepts

Line: 6 to 6
 

Description:

Changed:
<
<
The API's have been designed so that you have a minimum number of parameters to pass. They use the concept of the "current object", where Object can refer to a label, dataset, chart, etc. In other words, when adding data to a chart, you do not have to tell the API which chart you are adding it to, it will automatically add it to the "current" chart. Simiiarliy, when telling the API to render a chart, you do not have to tell it which chart, it will also automatically render the "current" chart. Or, when you create a label for your chart, the label just created will become the 'current' label and when you call other API routines to set the font, color or other attributes, it will automatically apply to that label. If you are working with more than one chart at a time, you can name each chart as you initialize it, and use a API to switch the current chart to one of the named charts. You can also name datasets, shapes and other objects. Normally you only need to do this if you are working with more than one of these at a time, otherwise, leaving the name blank will suffice.
>
>
The API's have been designed so that you have a minimum number of parameters to pass. They use the concept of the "current object", where Object can refer to a label, dataset, chart, etc. In other words, when adding data to a chart, you do not have to tell the API which chart you are adding it to, it will automatically add it to the "current" chart. Simiiarliy, when telling the API to render a chart, you do not have to tell it which chart, it will also automatically render the "current" chart. Or, when you create a label for your chart, the label just created will become the 'current' label and when you call other API routines to set the font, color or other attributes, it will automatically apply to that label. If you are working with more than one chart at a time, you can name each chart as you initialize it, and use an API to switch the current chart to one of the named charts. You can also name datasets, shapes and other objects. Normally you only need to do this if you are working with more than one of these at a time; otherwise, leaving the name blank will suffice.
 
Changed:
<
<
The API's may have one or more required parameters and one or more optional parameters. If you fail to PASS a required parameter, the API will CANCEL with a error message indicating which parameter is missing. When PASSing optional parameters, you may have to PASS dummy parameters to fill in any gaps. For example, if an API takes 3 optional parameters, and you want to PASS the a value to the second parameter, then you will have to PASS something for the first optional parameter, then then value you want for the second parameter. Otherwise, the API will associate your value with the first optional parameter, not the second.
>
>
The API's may have one or more required parameters and one or more optional parameters. If you fail to PASS a required parameter, the API will CANCEL with an error message indicating which parameter is missing. When PASSing optional parameters, you may have to PASS dummy parameters to fill in any gaps. For example, if an API takes 3 optional parameters, and you want to PASS a value to the second parameter, then you will have to PASS something for the first optional parameter, then the value you want for the second parameter. Otherwise, the API will associate your value with the first optional parameter, not the second.
  The parameters for the API's are case insensitive, so TOPLEFT is the same as tOpLeFt or tOPLEFt.
Line: 16 to 16
  The API names begin with a period to distinguish the external routines from the internal ones. You will notice a number of other subroutines in the 0CD application that do not begin with a period. These are the internal subroutines used by the API itself, do not try to call them directly.
Changed:
<
<
The 1CD application contains a number of examples, use it as a reference until you are familiar with using the API's. The examples come directly from the samples in the Chart Director documentation.
>
>
The 1CD application contains a number of examples. Use it as a reference until you are familiar with using the API's. The examples come directly from the samples in the Chart Director documentation.
 
Changed:
<
<
Finally, the code examples given in the wiki are designed to be copied and pasted into your own process. You should be able to select the example code, copy it to the clipboard and then paste it into the ILF editor via Option 8. Although the examples use a GOSUB command to call the API, you might want to consider using a SUBR with SUBPROCESS invocation instead. This will greatly reduce the size of the executable module and the time it takes to create the Em. There is a slight performance trade off, but unless you are generating serveral charts at a time it won't be noticed.
>
>
Finally, the code examples given in the wiki are designed to be copied and pasted into your own process. You should be able to select the example code, copy it to the clipboard and then paste it into the ILF editor. Although the examples use a GOSUB command to call the API, you might want to consider using a SUBR with SUBPROCESS invocation instead. This will greatly reduce the size of the executable module and the time it takes to create the Em. There is a slight performance trade off, but unless you are generating several charts at a time, it won't be noticed.
 

Comments

Read what other users have said about this page or add your own comments.

Revision 82013-05-27 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="CDChartDirectorDesignerAPI"

Key Concepts

Line: 18 to 18
  The 1CD application contains a number of examples, use it as a reference until you are familiar with using the API's. The examples come directly from the samples in the Chart Director documentation.
Changed:
<
<
Finally, the code examples given in the wiki are designed to be copied and pasted into your own process. You should be able to select the example code, copy it to the clipboard and then paste it into the ILF editor via Option 8.
>
>
Finally, the code examples given in the wiki are designed to be copied and pasted into your own process. You should be able to select the example code, copy it to the clipboard and then paste it into the ILF editor via Option 8. Although the examples use a GOSUB command to call the API, you might want to consider using a SUBR with SUBPROCESS invocation instead. This will greatly reduce the size of the executable module and the time it takes to create the Em. There is a slight performance trade off, but unless you are generating serveral charts at a time it won't be noticed.
 

Comments

Read what other users have said about this page or add your own comments.

Revision 72013-02-19 - RayPelegrino

Line: 1 to 1
 
META TOPICPARENT name="CDChartDirectorDesignerAPI"
Changed:
<
<

Key Concepts- Conceptos principales

>
>

Key Concepts

 
Changed:
<
<
Esta página describe los conceptos clave que usted debe saber antes de utilizar las API's.
>
>
This page describes de key concepts you should know before using the API's.
 
Changed:
<
<

Descripcion:

>
>

Description:

  The API's have been designed so that you have a minimum number of parameters to pass. They use the concept of the "current object", where Object can refer to a label, dataset, chart, etc. In other words, when adding data to a chart, you do not have to tell the API which chart you are adding it to, it will automatically add it to the "current" chart. Simiiarliy, when telling the API to render a chart, you do not have to tell it which chart, it will also automatically render the "current" chart. Or, when you create a label for your chart, the label just created will become the 'current' label and when you call other API routines to set the font, color or other attributes, it will automatically apply to that label. If you are working with more than one chart at a time, you can name each chart as you initialize it, and use a API to switch the current chart to one of the named charts. You can also name datasets, shapes and other objects. Normally you only need to do this if you are working with more than one of these at a time, otherwise, leaving the name blank will suffice.
Line: 19 to 19
 The 1CD application contains a number of examples, use it as a reference until you are familiar with using the API's. The examples come directly from the samples in the Chart Director documentation.

Finally, the code examples given in the wiki are designed to be copied and pasted into your own process. You should be able to select the example code, copy it to the clipboard and then paste it into the ILF editor via Option 8.

Changed:
<
<

Comentarios

>
>

Comments

  Read what other users have said about this page or add your own comments.

Revision 62013-02-16 - RayPelegrino

Line: 1 to 1
 
META TOPICPARENT name="CDChartDirectorDesignerAPI"
Changed:
<
<

Key Concepts

>
>

Key Concepts- Conceptos principales

 
Changed:
<
<
This page describes the key concepts you should know before using the API's.
>
>
Esta página describe los conceptos clave que usted debe saber antes de utilizar las API's.
 
Changed:
<
<

Description:

>
>

Descripcion:

  The API's have been designed so that you have a minimum number of parameters to pass. They use the concept of the "current object", where Object can refer to a label, dataset, chart, etc. In other words, when adding data to a chart, you do not have to tell the API which chart you are adding it to, it will automatically add it to the "current" chart. Simiiarliy, when telling the API to render a chart, you do not have to tell it which chart, it will also automatically render the "current" chart. Or, when you create a label for your chart, the label just created will become the 'current' label and when you call other API routines to set the font, color or other attributes, it will automatically apply to that label. If you are working with more than one chart at a time, you can name each chart as you initialize it, and use a API to switch the current chart to one of the named charts. You can also name datasets, shapes and other objects. Normally you only need to do this if you are working with more than one of these at a time, otherwise, leaving the name blank will suffice.
Line: 19 to 19
 The 1CD application contains a number of examples, use it as a reference until you are familiar with using the API's. The examples come directly from the samples in the Chart Director documentation.

Finally, the code examples given in the wiki are designed to be copied and pasted into your own process. You should be able to select the example code, copy it to the clipboard and then paste it into the ILF editor via Option 8.

Changed:
<
<

Comments

>
>

Comentarios

  Read what other users have said about this page or add your own comments.

Revision 52011-11-25 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="CDChartDirectorDesignerAPI"

Key Concepts

This page describes the key concepts you should know before using the API's.

Deleted:
<
<

 

Description:

Changed:
<
<
The API's have been designed so that you have a minimum number of parameters to pass. They use the concept of the "current object", where Object can refer to a label, dataset, chart, etc. In other words, when adding data to a chart, you do not have to tell the API which chart you are adding it to, it will automatically add it to the "current" chart. Simiiarliy, when telling the API to render a chart, you do not have to tell it which chart, it will also automatically render the "current" chart. If you are working with more than one chart at a time, you can name each chart as you initialize it, and use a API to switch the current chart to one of the named charts. Another example is when you create a label for your chart. The label just created will become the 'current' label, when you call other API routines to set the font, color or other attributes, it will automatically apply to that label.
>
>
The API's have been designed so that you have a minimum number of parameters to pass. They use the concept of the "current object", where Object can refer to a label, dataset, chart, etc. In other words, when adding data to a chart, you do not have to tell the API which chart you are adding it to, it will automatically add it to the "current" chart. Simiiarliy, when telling the API to render a chart, you do not have to tell it which chart, it will also automatically render the "current" chart. Or, when you create a label for your chart, the label just created will become the 'current' label and when you call other API routines to set the font, color or other attributes, it will automatically apply to that label. If you are working with more than one chart at a time, you can name each chart as you initialize it, and use a API to switch the current chart to one of the named charts. You can also name datasets, shapes and other objects. Normally you only need to do this if you are working with more than one of these at a time, otherwise, leaving the name blank will suffice.
  The API's may have one or more required parameters and one or more optional parameters. If you fail to PASS a required parameter, the API will CANCEL with a error message indicating which parameter is missing. When PASSing optional parameters, you may have to PASS dummy parameters to fill in any gaps. For example, if an API takes 3 optional parameters, and you want to PASS the a value to the second parameter, then you will have to PASS something for the first optional parameter, then then value you want for the second parameter. Otherwise, the API will associate your value with the first optional parameter, not the second.

Revision 42011-11-11 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="CDChartDirectorDesignerAPI"

Key Concepts

Line: 9 to 9
  The API's have been designed so that you have a minimum number of parameters to pass. They use the concept of the "current object", where Object can refer to a label, dataset, chart, etc. In other words, when adding data to a chart, you do not have to tell the API which chart you are adding it to, it will automatically add it to the "current" chart. Simiiarliy, when telling the API to render a chart, you do not have to tell it which chart, it will also automatically render the "current" chart. If you are working with more than one chart at a time, you can name each chart as you initialize it, and use a API to switch the current chart to one of the named charts. Another example is when you create a label for your chart. The label just created will become the 'current' label, when you call other API routines to set the font, color or other attributes, it will automatically apply to that label.
Changed:
<
<
The API's usually have one or more required parameters and possibly one more optional parameters. If you fail to PASS a required parameter, the API will CANCEL with a error message indicating which parameter is missing. When PASSing optional parameters, you may have to PASS dummy parameters to fill in any gaps. For example, if an API takes 3 optional parameters, and you want to PASS the a value to the second parameter, then you will have to PASS something for the first optional parameter, then then value you want for the second parameter. Otherwise, the API will associate your value with the first optional parameter, not the second.
>
>
The API's may have one or more required parameters and one or more optional parameters. If you fail to PASS a required parameter, the API will CANCEL with a error message indicating which parameter is missing. When PASSing optional parameters, you may have to PASS dummy parameters to fill in any gaps. For example, if an API takes 3 optional parameters, and you want to PASS the a value to the second parameter, then you will have to PASS something for the first optional parameter, then then value you want for the second parameter. Otherwise, the API will associate your value with the first optional parameter, not the second.
  The parameters for the API's are case insensitive, so TOPLEFT is the same as tOpLeFt or tOPLEFt.
Line: 18 to 18
 The API names begin with a period to distinguish the external routines from the internal ones. You will notice a number of other subroutines in the 0CD application that do not begin with a period. These are the internal subroutines used by the API itself, do not try to call them directly.

The 1CD application contains a number of examples, use it as a reference until you are familiar with using the API's. The examples come directly from the samples in the Chart Director documentation.

Added:
>
>
Finally, the code examples given in the wiki are designed to be copied and pasted into your own process. You should be able to select the example code, copy it to the clipboard and then paste it into the ILF editor via Option 8.
 

Comments

Read what other users have said about this page or add your own comments.

Revision 32011-09-23 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="CDChartDirectorDesignerAPI"

Key Concepts

Line: 11 to 11
  The API's usually have one or more required parameters and possibly one more optional parameters. If you fail to PASS a required parameter, the API will CANCEL with a error message indicating which parameter is missing. When PASSing optional parameters, you may have to PASS dummy parameters to fill in any gaps. For example, if an API takes 3 optional parameters, and you want to PASS the a value to the second parameter, then you will have to PASS something for the first optional parameter, then then value you want for the second parameter. Otherwise, the API will associate your value with the first optional parameter, not the second.
Added:
>
>
The parameters for the API's are case insensitive, so TOPLEFT is the same as tOpLeFt or tOPLEFt.
 For every API, there is a work field of the same name that will contain any return codes from the API. You can test this work field for a non blank value after returning to see if an error occurred. The work fields are tokenized, so you can SCAN the possible values in the ILF editor.

The API names begin with a period to distinguish the external routines from the internal ones. You will notice a number of other subroutines in the 0CD application that do not begin with a period. These are the internal subroutines used by the API itself, do not try to call them directly.

Revision 22011-09-21 - JeanNeron

Line: 1 to 1
 
META TOPICPARENT name="CDChartDirectorDesignerAPI"

Key Concepts

Line: 7 to 7
 

Description:

Changed:
<
<
The API's have been designed so that you have a minimum number of parameters to pass. They use the concept of the "current object", where Object can refer to a label, dataset, chart, etc. In other words, when adding data to a chart, you do not have to tell the API which chart you are adding it to, it will automatically add it to the "current" chart. Simiiarliy, when telling the API to render a chart, you do not have to tell it which chart, it will also automatically render the "current" chart. If you are working with more than one chart at a time, you can name each chart as you initialize it, and use a API to switch the current chart to one of the named charts.
>
>
The API's have been designed so that you have a minimum number of parameters to pass. They use the concept of the "current object", where Object can refer to a label, dataset, chart, etc. In other words, when adding data to a chart, you do not have to tell the API which chart you are adding it to, it will automatically add it to the "current" chart. Simiiarliy, when telling the API to render a chart, you do not have to tell it which chart, it will also automatically render the "current" chart. If you are working with more than one chart at a time, you can name each chart as you initialize it, and use a API to switch the current chart to one of the named charts. Another example is when you create a label for your chart. The label just created will become the 'current' label, when you call other API routines to set the font, color or other attributes, it will automatically apply to that label.
 
Changed:
<
<
The API's usually have one or more required parameters and possibly one more optional parameters. If you fail to PASS a required parameter, the API will CANCEL with a error message indicating which parameter is missing. When PASSing optional parameters, you may have to PASS dummy parameters to fill in any "gaps". For example, if an API takes 3 optional parameters, and you want to PASS the a value to the second parameter, then you will have to PASS something for the first optional parameter, then then value you want for the second parameter. Otherwise, the API will associate your value with the first optional parameter, not the second.
>
>
The API's usually have one or more required parameters and possibly one more optional parameters. If you fail to PASS a required parameter, the API will CANCEL with a error message indicating which parameter is missing. When PASSing optional parameters, you may have to PASS dummy parameters to fill in any gaps. For example, if an API takes 3 optional parameters, and you want to PASS the a value to the second parameter, then you will have to PASS something for the first optional parameter, then then value you want for the second parameter. Otherwise, the API will associate your value with the first optional parameter, not the second.
 
Changed:
<
<
For every API, there is a work field of the same name that will contain any return codes from the API. You can test this work field for a non zero value after returning to see if an error occurred. The work fields are tokenized, so you can SCAN the possible values in the ILF editor.
>
>
For every API, there is a work field of the same name that will contain any return codes from the API. You can test this work field for a non blank value after returning to see if an error occurred. The work fields are tokenized, so you can SCAN the possible values in the ILF editor.
  The API names begin with a period to distinguish the external routines from the internal ones. You will notice a number of other subroutines in the 0CD application that do not begin with a period. These are the internal subroutines used by the API itself, do not try to call them directly.
Changed:
<
<
The 1CD application contains a number of examples, use it as a reference until you are familiar with using the API's.
>
>
The 1CD application contains a number of examples, use it as a reference until you are familiar with using the API's. The examples come directly from the samples in the Chart Director documentation.
 

Comments

Read what other users have said about this page or add your own comments.

Revision 12011-09-15 - JeanNeron

Line: 1 to 1
Added:
>
>
META TOPICPARENT name="CDChartDirectorDesignerAPI"

Key Concepts

This page describes the key concepts you should know before using the API's.


Description:

The API's have been designed so that you have a minimum number of parameters to pass. They use the concept of the "current object", where Object can refer to a label, dataset, chart, etc. In other words, when adding data to a chart, you do not have to tell the API which chart you are adding it to, it will automatically add it to the "current" chart. Simiiarliy, when telling the API to render a chart, you do not have to tell it which chart, it will also automatically render the "current" chart. If you are working with more than one chart at a time, you can name each chart as you initialize it, and use a API to switch the current chart to one of the named charts.

The API's usually have one or more required parameters and possibly one more optional parameters. If you fail to PASS a required parameter, the API will CANCEL with a error message indicating which parameter is missing. When PASSing optional parameters, you may have to PASS dummy parameters to fill in any "gaps". For example, if an API takes 3 optional parameters, and you want to PASS the a value to the second parameter, then you will have to PASS something for the first optional parameter, then then value you want for the second parameter. Otherwise, the API will associate your value with the first optional parameter, not the second.

For every API, there is a work field of the same name that will contain any return codes from the API. You can test this work field for a non zero value after returning to see if an error occurred. The work fields are tokenized, so you can SCAN the possible values in the ILF editor.

The API names begin with a period to distinguish the external routines from the internal ones. You will notice a number of other subroutines in the 0CD application that do not begin with a period. These are the internal subroutines used by the API itself, do not try to call them directly.

The 1CD application contains a number of examples, use it as a reference until you are familiar with using the API's.

Comments

Read what other users have said about this page or add your own comments.


<--/commentPlugin-->

-- JeanNeron - 2011-09-15

 
This site is powered by the TWiki collaboration platform Powered by PerlCopyright © 2008-2022 by the contributing authors. All material on this collaboration platform is the property of the contributing authors.
Ideas, requests, problems regarding TWiki? Send feedback