WordPress.org
Get WordPress

Make WordPress Core

Changeset 22619


Ignore:
Timestamp:
11/16/2012 10:02:21 PM (14 years ago)
Author:
ryan
Message:

Add abstract methods back to WP_Image_Editor and refresh phpdoc.

Props DH-Shredder, markoheijnen, kurtpayne, nacin
see #6821

Location:
trunk/wp-includes
Files:
3 edited

Legend:

Unmodified
Added
Removed

  • trunk/wp-includes/class-wp-image-editor-gd.php

    r22538 r22619  
    2626
    2727        /**
    28          * Checks to see if current environment supports GD
     28         * Checks to see if current environment supports GD.
    2929         *
    3030         * @since 3.5.0
    … …  
    4141
    4242        /**
    43          * Loads image from $this->file into new GD Resource
    44          *
    45          * @since 3.5
     43         * Loads image from $this->file into new GD Resource.
     44         *
     45         * @since 3.5.0
    4646         * @access protected
    4747         *
    … …  
    7373
    7474        /**
    75          * Sets or updates current image size
     75         * Sets or updates current image size.
    7676         *
    7777         * @since 3.5.0
    … …  
    9292
    9393        /**
    94          * Checks to see if editor supports mime-type specified
     94         * Checks to see if editor supports the mime-type specified.
    9595         *
    9696         * @since 3.5.0
    … …  
    108108        /**
    109109         * Resizes current image.
    110          * Wrapper around _resize, since _resize returns a GD Resource
     110         * Wraps _resize, since _resize returns a GD Resource.
     111         *
     112         * @since 3.5.0
     113         * @access public
    111114         *
    112115         * @param int $max_w
    … …  
    153156         * Processes current image and saves to disk
    154157         * multiple sizes from single source.
     158         *
     159         * @since 3.5.0
     160         * @access public
    155161         *
    156162         * @param array $sizes { {width, height}, ... }
    … …  
    193199         * @param int $dst_w Optional. The destination width.
    194200         * @param int $dst_h Optional. The destination height.
    195          * @param int $src_abs Optional. If the source crop points are absolute.
     201         * @param boolean $src_abs Optional. If the source crop points are absolute.
    196202         * @return boolean|WP_Error
    197203         */
    … …  
    251257
    252258        /**
    253          * Flips current image
     259         * Flips current image.
     260         *
     261         * @since 3.5.0
     262         * @access public
    254263         *
    255264         * @param boolean $horz Horizonal Flip
    … …  
    278287
    279288        /**
    280          * Saves current in-memory image to file
     289         * Saves current in-memory image to file.
     290         *
     291         * @since 3.5.0
     292         * @access public
    281293         *
    282294         * @param string $destfilename
    … …  
    336348
    337349        /**
    338          * Returns stream of current image
     350         * Returns stream of current image.
     351         *
     352         * @since 3.5.0
     353         * @access public
    339354         *
    340355         * @param string $mime_type

  • trunk/wp-includes/class-wp-image-editor-imagick.php

    r22581 r22619  
    4545
    4646        /**
    47          * Loads image from $this->file into new Imagick Object
     47         * Loads image from $this->file into new Imagick Object.
    4848         *
    4949         * @since 3.5.0
    … …  
    110110
    111111        /**
    112          * Sets or updates current image size
     112         * Sets or updates current image size.
    113113         *
    114114         * @since 3.5.0
    … …  
    139139
    140140        /**
    141          * Checks to see if editor supports mime-type specified
     141         * Checks to see if editor supports the mime-type specified.
    142142         *
    143143         * @since 3.5.0
    … …  
    163163        /**
    164164         * Resizes current image.
     165         *
     166         * @since 3.5.0
     167         * @access public
    165168         *
    166169         * @param int $max_w
    … …  
    199202         * Processes current image and saves to disk
    200203         * multiple sizes from single source.
     204         *
     205         * @since 3.5.0
     206         * @access public
    201207         *
    202208         * @param array $sizes
    … …  
    247253         * @param int $dst_w Optional. The destination width.
    248254         * @param int $dst_h Optional. The destination height.
    249          * @param int $src_abs Optional. If the source crop points are absolute.
     255         * @param boolean $src_abs Optional. If the source crop points are absolute.
    250256         * @return boolean|WP_Error
    251257         */
    252258        public function crop( $src_x, $src_y, $src_w, $src_h, $dst_w = null, $dst_h = null, $src_abs = false ) {
    253                 // Not sure this is compatible.
    254259                if ( $src_abs ) {
    255260                        $src_w -= $src_x;
    … …  
    303308
    304309        /**
    305          * Flips current image
    306          *
    307          * @since 3.5.0
    308          * @access public
    309          *
    310          * @param boolean $horz Horizontal Flip
     310         * Flips current image.
     311         *
     312         * @since 3.5.0
     313         * @access public
     314         *
     315         * @param boolean $horz Horizonal Flip
    311316         * @param boolean $vert Vertical Flip
    312          * @returns boolean
     317         * @returns boolean|WP_Error
    313318         */
    314319        public function flip( $horz, $vert ) {
    … …  
    327332
    328333        /**
    329          * Saves current image to file
     334         * Saves current image to file.
     335         *
     336         * @since 3.5.0
     337         * @access public
    330338         *
    331339         * @param string $destfilename
    … …  
    386394
    387395        /**
    388          * Streams current image to browser
     396         * Streams current image to browser.
     397         *
     398         * @since 3.5.0
     399         * @access public
    389400         *
    390401         * @param string $mime_type

  • trunk/wp-includes/class-wp-image-editor.php

    r22511 r22619  
    6363
    6464                if ( ! $required_methods )
    65                         $required_methods = apply_filters( 'wp_image_editor_default_methods',
    66                                 array( 'resize', 'multi_resize', 'crop', 'rotate', 'flip', 'stream' ) );
     65                        $required_methods = array();
    6766
    6867                // Loop over each editor on each request looking for one which will serve this request's needs
    … …  
    8180        }
    8281
    83         abstract protected function load(); // returns bool|WP_Error
     82        /**
     83         * Loads image from $this->file into editor.
     84         *
     85         * @since 3.5.0
     86         * @access protected
     87         * @abstract
     88         *
     89         * @return boolean|WP_Error True if loaded; WP_Error on failure.
     90         */
     91        abstract protected function load();
     92
     93        /**
     94         * Saves current image to file.
     95         *
     96         * @since 3.5.0
     97         * @access public
     98         * @abstract
     99         *
     100         * @param string $destfilename
     101         * @param string $mime_type
     102         * @return array|WP_Error {'path'=>string, 'file'=>string, 'width'=>int, 'height'=>int, 'mime-type'=>string}
     103         */
    84104        abstract public function save( $destfilename = null, $mime_type = null );
    85105
    86106        /**
    87          * Implement all of the below to support natively used functions:
    88          *
    89          * public function resize( $max_w, $max_h, $crop = false )
    90          * public function multi_resize( $sizes )
    91          * public function crop( $src_x, $src_y, $src_w, $src_h, $dst_w = null, $dst_h = null, $src_abs = false )
    92          * public function rotate( $angle )
    93          * public function flip( $horz, $vert )
    94          * public function stream( $mime_type = null )
    95          */
     107         * Resizes current image.
     108         *
     109         * @since 3.5.0
     110         * @access public
     111         * @abstract
     112         *
     113         * @param int $max_w
     114         * @param int $max_h
     115         * @param boolean $crop
     116         * @return boolean|WP_Error
     117         */
     118        abstract public function resize( $max_w, $max_h, $crop = false );
     119
     120        /**
     121         * Processes current image and saves to disk
     122         * multiple sizes from single source.
     123         *
     124         * @since 3.5.0
     125         * @access public
     126         * @abstract
     127         *
     128         * @param array $sizes
     129         * @return array
     130         */
     131        abstract public function multi_resize( $sizes );
     132
     133        /**
     134         * Crops Image.
     135         *
     136         * @since 3.5.0
     137         * @access public
     138         * @abstract
     139         *
     140         * @param string|int $src The source file or Attachment ID.
     141         * @param int $src_x The start x position to crop from.
     142         * @param int $src_y The start y position to crop from.
     143         * @param int $src_w The width to crop.
     144         * @param int $src_h The height to crop.
     145         * @param int $dst_w Optional. The destination width.
     146         * @param int $dst_h Optional. The destination height.
     147         * @param boolean $src_abs Optional. If the source crop points are absolute.
     148         * @return boolean|WP_Error
     149         */
     150        abstract public function crop( $src_x, $src_y, $src_w, $src_h, $dst_w = null, $dst_h = null, $src_abs = false );
     151
     152        /**
     153         * Rotates current image counter-clockwise by $angle.
     154         *
     155         * @since 3.5.0
     156         * @access public
     157         * @abstract
     158         *
     159         * @param float $angle
     160         * @return boolean|WP_Error
     161         */
     162        abstract public function rotate( $angle );
     163
     164        /**
     165         * Flips current image.
     166         *
     167         * @since 3.5.0
     168         * @access public
     169         * @abstract
     170         *
     171         * @param boolean $horz Horizonal Flip
     172         * @param boolean $vert Vertical Flip
     173         * @return boolean|WP_Error
     174         */
     175        abstract public function flip( $horz, $vert );
     176
     177        /**
     178         * Streams current image to browser.
     179         *
     180         * @since 3.5.0
     181         * @access public
     182         * @abstract
     183         *
     184         * @param string $mime_type
     185         * @return boolean|WP_Error
     186         */
     187        abstract public function stream( $mime_type = null );
    96188
    97189        /**
    … …  
    111203
    112204        /**
    113          * Checks to see if editor supports mime-type specified
     205         * Checks to see if editor supports the mime-type specified.
    114206         * Must be overridden in a sub-class.
    115207         *
    … …  
    126218
    127219        /**
    128          * Gets dimensions of image
     220         * Gets dimensions of image.
    129221         *
    130222         * @since 3.5.0
    … …  
    138230
    139231        /**
    140          * Sets current image size
     232         * Sets current image size.
    141233         *
    142234         * @since 3.5.0
Note: See TracChangeset for help on using the changeset viewer.