4D v16.3

Equal pictures

Home

 
4D v16.3
Equal pictures

Equal pictures 


 

Equal pictures ( picture1 ; picture2 ; mask ) -> Function result 
Parameter Type   Description
picture1  Picture field, Picture variable in Original source picture
picture2  Picture field, Picture variable in Picture to compare
mask  Picture field, Picture variable in Resulting mask
Function result  Boolean in True if both pictures are identical; otherwise, False

The Equal pictures command precisely compares both the dimensions and the contents of two pictures.

Pass the source picture in picture1 and the picture you want to compare with it in picture2

  • If the pictures are not the same dimension, the command returns False and the mask parameter contains a blank picture. 
  • If the pictures are of the same dimension but with different contents, the command returns False and the mask parameter contains the resulting picture mask based on a comparison of the two pictures. This comparison is performed pixel by pixel, and each pixel that does not match appears white on a black background. 
  • If both pictures are exactly the same, the command returns True and the mask parameter contains a picture that is completely black.

If the command is executed successfully (the two pictures are compared), the system variable OK is set to 1. In the case of an anomaly, particularly if one of the pictures is not initialized (blank picture), the OK variable is set to 0.

Example  

In the following example, we compare two pictures (pict1 and pict2) and display the resulting mask:

Here is the code for the Compare button:

 $equal :=Equal pictures($pict1;$pict2;$mask)

 
PROPERTIES 

Product: 4D
Theme: Pictures
Number: 1196

The OK variable is changed by the commandThis command can be run in preemptive processes

 
HISTORY 

Created: 4D v13

 
ARTICLE USAGE

4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)