From a87cd822743f9b2c9cb45fb4e7680f420439afd8 Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Wed, 14 Mar 2018 11:26:31 +0000 Subject: [PATCH 01/19] Example m.sticker event --- event-schemas/examples/m.sticker | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) create mode 100644 event-schemas/examples/m.sticker diff --git a/event-schemas/examples/m.sticker b/event-schemas/examples/m.sticker new file mode 100644 index 00000000000..f00e5b238e5 --- /dev/null +++ b/event-schemas/examples/m.sticker @@ -0,0 +1,25 @@ +{ + "age": 242352, + "content": { + "body": "Landing", + "info": { + "mimetype": "image/png", + "thumbnail_info": { + "mimetype": "image/png", + "h": 200, + "w": 140, + "size": 73602 + }, + "h": 200, + "thumbnail_url": "mxc://matrix.org/sHhqkFCvSkFwtmvtETOtKnLP", + "w": 140, + "size": 73602 + }, + "url": "mxc://matrix.org/sHhqkFCvSkFwtmvtETOtKnLP" + }, + "origin_server_ts": 1431961217939, + "event_id": "$WLGTSEFSEF:localhost", + "type": "m.sticker", + "room_id": "!Cuyf34gef24t:localhost", + "sender": "@example:localhost" +} From 2989406f0a7debd0b863906aca2061bb8bbdc7ae Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Wed, 14 Mar 2018 11:28:44 +0000 Subject: [PATCH 02/19] Very basic m.sticker description. --- specification/modules/stickers.rst | 30 ++++++++++++++++++++++++++++++ 1 file changed, 30 insertions(+) create mode 100644 specification/modules/stickers.rst diff --git a/specification/modules/stickers.rst b/specification/modules/stickers.rst new file mode 100644 index 00000000000..41ada82db6c --- /dev/null +++ b/specification/modules/stickers.rst @@ -0,0 +1,30 @@ +.. Copyright 2018 New Vector Ltd. +.. +.. Licensed under the Apache License, Version 2.0 (the "License"); +.. you may not use this file except in compliance with the License. +.. You may obtain a copy of the License at +.. +.. http://www.apache.org/licenses/LICENSE-2.0 +.. +.. Unless required by applicable law or agreed to in writing, software +.. distributed under the License is distributed on an "AS IS" BASIS, +.. WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +.. See the License for the specific language governing permissions and +.. limitations under the License. + +Sticker Messages +================ + +.. _module:stickers: + +This module allows users to send sticker messages in to rooms or direct messaging sessions. +Sticker messages are specialised image messages that are displayed without controls. + +Events +------ +Sticker events are received as single ``m.sticker`` event in the +``timeline`` section of a room in a ``/sync``. + +``m.sticker`` +~~~~~~~~~~~~~~~~~~~~~~~~ +{{m_sticker_event}} From 91f1834cae6fc931a80fb8ca1d20308e48cfb00d Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Wed, 14 Mar 2018 11:29:11 +0000 Subject: [PATCH 03/19] m.sticker event definition. --- event-schemas/schema/m.sticker | 28 ++++++++++++++++++++++++++++ specification/targets.yaml | 1 + 2 files changed, 29 insertions(+) create mode 100644 event-schemas/schema/m.sticker diff --git a/event-schemas/schema/m.sticker b/event-schemas/schema/m.sticker new file mode 100644 index 00000000000..bd2f558051a --- /dev/null +++ b/event-schemas/schema/m.sticker @@ -0,0 +1,28 @@ +--- +allOf: + - $ref: core-event-schema/room_event.yaml +description: This message represents a single sticker image. +properties: + content: + properties: + body: + description: "A textual representation of the sticker image. This could be the alt text of the image, the filename of the image, or some kind of content description for accessibility e.g. 'image attachment'." + type: string + info: + allOf: + - $ref: core-event-schema/msgtype_infos/image_info.yaml + description: Metadata about the image referred to in ``url``. + url: + description: The URL to the sticker image. + type: string + required: + - body + - info + - url + type: object + type: + enum: + - m.sticker + type: string +title: StickerMessage +type: object diff --git a/specification/targets.yaml b/specification/targets.yaml index 122904e9886..50a9fb8d5b1 100644 --- a/specification/targets.yaml +++ b/specification/targets.yaml @@ -62,6 +62,7 @@ groups: # reusable blobs of files when prefixed with 'group:' - modules/cas_login.rst - modules/dm.rst - modules/ignore_users.rst + - modules/stickers.rst title_styles: ["=", "-", "~", "+", "^", "`", "@", ":"] From c471f486369f704d0b58eb8e734f83a670e5db74 Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Wed, 14 Mar 2018 14:25:00 +0000 Subject: [PATCH 04/19] Additional event structure detail. --- event-schemas/schema/m.sticker | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/event-schemas/schema/m.sticker b/event-schemas/schema/m.sticker index bd2f558051a..8fe88f5049f 100644 --- a/event-schemas/schema/m.sticker +++ b/event-schemas/schema/m.sticker @@ -6,12 +6,12 @@ properties: content: properties: body: - description: "A textual representation of the sticker image. This could be the alt text of the image, the filename of the image, or some kind of content description for accessibility e.g. 'image attachment'." + description: "A textual representation or associated description of the sticker image. This could be the alt text of the original image, or a message to accompany and further describe the sticker." type: string info: allOf: - $ref: core-event-schema/msgtype_infos/image_info.yaml - description: Metadata about the image referred to in ``url``. + description: Metadata about the image referred to in ``url`` including a thumbnail representation. url: description: The URL to the sticker image. type: string From 0f8e34d49031a02395eb0bbc6f85bf4478085974 Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Wed, 14 Mar 2018 15:01:07 +0000 Subject: [PATCH 05/19] Update m.sticker description with more detail. --- specification/modules/stickers.rst | 16 +++++++++++++--- 1 file changed, 13 insertions(+), 3 deletions(-) diff --git a/specification/modules/stickers.rst b/specification/modules/stickers.rst index 41ada82db6c..30fada80204 100644 --- a/specification/modules/stickers.rst +++ b/specification/modules/stickers.rst @@ -18,13 +18,23 @@ Sticker Messages .. _module:stickers: This module allows users to send sticker messages in to rooms or direct messaging sessions. -Sticker messages are specialised image messages that are displayed without controls. + +Sticker messages are specialised image messages that are displayed without controls (e.g. no "download" link, or light-box view on click, as would be displayed for for m.room.message#m.image events). + +Sticker messages are intended to provide simple "reaction" events in the message timeline. The matrix client should provide some mechanism to display the sticker "body" e.g. as a tooltip on hover, or in a modal when the sticker image is clicked. Events ------ Sticker events are received as single ``m.sticker`` event in the ``timeline`` section of a room in a ``/sync``. -``m.sticker`` -~~~~~~~~~~~~~~~~~~~~~~~~ {{m_sticker_event}} + +Client behaviour +---------------- + +Clients supporting this message type should display the image content from the event URL directly in the timeline. + +A thumbnail image should be provided in the message info. object. This is largely intended as a fallback for clients that do not fully support the m.sticker event type. Im most cases it is fine to set the thumbnail URL to the same URL as the main event content. + +It is recommended that sticker image content should be approximately 400x400 pixels in size (or smaller). The image dimensions specified in the info. object of the message should be half of the original image dimensions in order to display correctly on retina displays. From f4213373f53f78d224785e72f242b83d783fb7e3 Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Thu, 15 Mar 2018 10:02:15 +0000 Subject: [PATCH 06/19] Wrap lines at 80 cols. --- event-schemas/schema/m.sticker | 9 +++++++-- specification/modules/stickers.rst | 25 +++++++++++++++++++------ 2 files changed, 26 insertions(+), 8 deletions(-) diff --git a/event-schemas/schema/m.sticker b/event-schemas/schema/m.sticker index 8fe88f5049f..e639823ce7a 100644 --- a/event-schemas/schema/m.sticker +++ b/event-schemas/schema/m.sticker @@ -6,12 +6,17 @@ properties: content: properties: body: - description: "A textual representation or associated description of the sticker image. This could be the alt text of the original image, or a message to accompany and further describe the sticker." + description: |- + A textual representation or associated description of the sticker + image. This could be the alt text of the original image, or a message + to accompany and further describe the sticker. type: string info: allOf: - $ref: core-event-schema/msgtype_infos/image_info.yaml - description: Metadata about the image referred to in ``url`` including a thumbnail representation. + description: |- + Metadata about the image referred to in ``url`` including a thumbnail + representation. url: description: The URL to the sticker image. type: string diff --git a/specification/modules/stickers.rst b/specification/modules/stickers.rst index 30fada80204..49071761a9b 100644 --- a/specification/modules/stickers.rst +++ b/specification/modules/stickers.rst @@ -17,11 +17,17 @@ Sticker Messages .. _module:stickers: -This module allows users to send sticker messages in to rooms or direct messaging sessions. +This module allows users to send sticker messages in to rooms or direct +messaging sessions. -Sticker messages are specialised image messages that are displayed without controls (e.g. no "download" link, or light-box view on click, as would be displayed for for m.room.message#m.image events). +Sticker messages are specialised image messages that are displayed without +controls (e.g. no "download" link, or light-box view on click, as would be +displayed for for m.room.message#m.image events). -Sticker messages are intended to provide simple "reaction" events in the message timeline. The matrix client should provide some mechanism to display the sticker "body" e.g. as a tooltip on hover, or in a modal when the sticker image is clicked. +Sticker messages are intended to provide simple "reaction" events in the message +timeline. The matrix client should provide some mechanism to display the sticker +"body" e.g. as a tooltip on hover, or in a modal when the sticker image is +clicked. Events ------ @@ -33,8 +39,15 @@ Sticker events are received as single ``m.sticker`` event in the Client behaviour ---------------- -Clients supporting this message type should display the image content from the event URL directly in the timeline. +Clients supporting this message type should display the image content from the +event URL directly in the timeline. -A thumbnail image should be provided in the message info. object. This is largely intended as a fallback for clients that do not fully support the m.sticker event type. Im most cases it is fine to set the thumbnail URL to the same URL as the main event content. +A thumbnail image should be provided in the message info. object. This is +largely intended as a fallback for clients that do not fully support the +m.sticker event type. Im most cases it is fine to set the thumbnail URL to the +same URL as the main event content. -It is recommended that sticker image content should be approximately 400x400 pixels in size (or smaller). The image dimensions specified in the info. object of the message should be half of the original image dimensions in order to display correctly on retina displays. +It is recommended that sticker image content should be approximately 400x400 +pixels in size (or smaller). The image dimensions specified in the info. object +of the message should be half of the original image dimensions in order to +display correctly on retina displays. From c59b879a2806f6ce413a8bfe6fe05d3d00705c3b Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Thu, 15 Mar 2018 10:21:10 +0000 Subject: [PATCH 07/19] Add backlink to m.image event definition. --- specification/modules/stickers.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/modules/stickers.rst b/specification/modules/stickers.rst index 49071761a9b..315073aa09b 100644 --- a/specification/modules/stickers.rst +++ b/specification/modules/stickers.rst @@ -22,7 +22,7 @@ messaging sessions. Sticker messages are specialised image messages that are displayed without controls (e.g. no "download" link, or light-box view on click, as would be -displayed for for m.room.message#m.image events). +displayed for for `m.image`_ events). Sticker messages are intended to provide simple "reaction" events in the message timeline. The matrix client should provide some mechanism to display the sticker From 250ada783dfd408c80a55f91c4004fd2f8af1f10 Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Thu, 15 Mar 2018 10:22:53 +0000 Subject: [PATCH 08/19] Update sticker resolution recommendation. --- specification/modules/stickers.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/modules/stickers.rst b/specification/modules/stickers.rst index 315073aa09b..052ab5af733 100644 --- a/specification/modules/stickers.rst +++ b/specification/modules/stickers.rst @@ -47,7 +47,7 @@ largely intended as a fallback for clients that do not fully support the m.sticker event type. Im most cases it is fine to set the thumbnail URL to the same URL as the main event content. -It is recommended that sticker image content should be approximately 400x400 +It is recommended that sticker image content should be approximately 512x512 pixels in size (or smaller). The image dimensions specified in the info. object of the message should be half of the original image dimensions in order to display correctly on retina displays. From a1fdecc5e2899122a4e4a3120f2f2a169c452174 Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Thu, 15 Mar 2018 10:26:31 +0000 Subject: [PATCH 09/19] Misc fixes. --- specification/modules/stickers.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/specification/modules/stickers.rst b/specification/modules/stickers.rst index 052ab5af733..a60fb8d760d 100644 --- a/specification/modules/stickers.rst +++ b/specification/modules/stickers.rst @@ -42,9 +42,9 @@ Client behaviour Clients supporting this message type should display the image content from the event URL directly in the timeline. -A thumbnail image should be provided in the message info. object. This is +A thumbnail image should be provided in the ``info`` object. This is largely intended as a fallback for clients that do not fully support the -m.sticker event type. Im most cases it is fine to set the thumbnail URL to the +``m.sticker`` event type. In most cases it is fine to set the thumbnail URL to the same URL as the main event content. It is recommended that sticker image content should be approximately 512x512 From 8dd7bd5ba5f3e76f804d83548ac90407a57d71a4 Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Thu, 15 Mar 2018 11:02:43 +0000 Subject: [PATCH 10/19] Fix grammar (slightly). --- specification/modules/stickers.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/specification/modules/stickers.rst b/specification/modules/stickers.rst index a60fb8d760d..a457678e778 100644 --- a/specification/modules/stickers.rst +++ b/specification/modules/stickers.rst @@ -31,8 +31,8 @@ clicked. Events ------ -Sticker events are received as single ``m.sticker`` event in the -``timeline`` section of a room in a ``/sync``. +Sticker events are received as a single ``m.sticker`` event in the +``timeline`` section of a room, in a ``/sync``. {{m_sticker_event}} From 1d9de287d07b539c3fad70cc794b08a7645047d8 Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Thu, 15 Mar 2018 18:03:49 +0000 Subject: [PATCH 11/19] Fix formatting. --- specification/modules/stickers.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/modules/stickers.rst b/specification/modules/stickers.rst index a457678e778..f7943b0e45f 100644 --- a/specification/modules/stickers.rst +++ b/specification/modules/stickers.rst @@ -48,6 +48,6 @@ largely intended as a fallback for clients that do not fully support the same URL as the main event content. It is recommended that sticker image content should be approximately 512x512 -pixels in size (or smaller). The image dimensions specified in the info. object +pixels in size (or smaller). The image dimensions specified in the ``info`` object of the message should be half of the original image dimensions in order to display correctly on retina displays. From 43d9543f48eed56395a3e468f410efa1f34ea662 Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Thu, 15 Mar 2018 18:17:33 +0000 Subject: [PATCH 12/19] Improve wording. --- specification/modules/stickers.rst | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/specification/modules/stickers.rst b/specification/modules/stickers.rst index f7943b0e45f..6b809510aab 100644 --- a/specification/modules/stickers.rst +++ b/specification/modules/stickers.rst @@ -47,7 +47,7 @@ largely intended as a fallback for clients that do not fully support the ``m.sticker`` event type. In most cases it is fine to set the thumbnail URL to the same URL as the main event content. -It is recommended that sticker image content should be approximately 512x512 -pixels in size (or smaller). The image dimensions specified in the ``info`` object -of the message should be half of the original image dimensions in order to -display correctly on retina displays. +It is recommended that sticker image content should be 512x512 pixels in size +or smaller. The image dimensions specified in the ``info`` object of the +message should be half of the original image dimensions in order to assist +rendering sharp images on higher DPI screens. From 90d99602e120d974f40bd15bc8f3fd963c2f3bef Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Fri, 23 Mar 2018 12:11:05 +0000 Subject: [PATCH 13/19] Specify that the `url` key should point to a valid MXC URI --- specification/modules/stickers.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/specification/modules/stickers.rst b/specification/modules/stickers.rst index 6b809510aab..71c388c41c9 100644 --- a/specification/modules/stickers.rst +++ b/specification/modules/stickers.rst @@ -42,6 +42,8 @@ Client behaviour Clients supporting this message type should display the image content from the event URL directly in the timeline. +The event ``url`` key must specify a valid ``mxc://`` URI. + A thumbnail image should be provided in the ``info`` object. This is largely intended as a fallback for clients that do not fully support the ``m.sticker`` event type. In most cases it is fine to set the thumbnail URL to the From eb7bbcf9169e701e743beb76356ca4bb432f503a Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Fri, 23 Mar 2018 12:39:29 +0000 Subject: [PATCH 14/19] Clarify image sizing guidelines. --- .../schema/core-event-schema/msgtype_infos/image_info.yaml | 6 ++++-- specification/modules/stickers.rst | 4 ++-- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/event-schemas/schema/core-event-schema/msgtype_infos/image_info.yaml b/event-schemas/schema/core-event-schema/msgtype_infos/image_info.yaml index b4eab413a2c..ed4f3fdf9f2 100644 --- a/event-schemas/schema/core-event-schema/msgtype_infos/image_info.yaml +++ b/event-schemas/schema/core-event-schema/msgtype_infos/image_info.yaml @@ -2,10 +2,12 @@ $schema: http://json-schema.org/draft-04/schema# description: Metadata about an image. properties: h: - description: The height of the image in pixels. + description: The intended display height of the image in pixels. This may + differ from the intrinsic dimensions of the image file. type: integer w: - description: The width of the image in pixels. + description: The intended display width of the image in pixels. This may + differ from the intrinsic dimensions of the image file. type: integer mimetype: description: The mimetype of the image, e.g. ``image/jpeg``. diff --git a/specification/modules/stickers.rst b/specification/modules/stickers.rst index 71c388c41c9..b502600ef32 100644 --- a/specification/modules/stickers.rst +++ b/specification/modules/stickers.rst @@ -50,6 +50,6 @@ largely intended as a fallback for clients that do not fully support the same URL as the main event content. It is recommended that sticker image content should be 512x512 pixels in size -or smaller. The image dimensions specified in the ``info`` object of the -message should be half of the original image dimensions in order to assist +or smaller. The dimensions of the image file should be twice the intended +display size specified in the ``info`` object, in order to assist rendering sharp images on higher DPI screens. From 618096efbe4320b52ddb6f65b879656b62a5b147 Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Fri, 23 Mar 2018 12:49:13 +0000 Subject: [PATCH 15/19] Move MXC requirement to schema. --- event-schemas/schema/m.sticker | 3 ++- specification/modules/stickers.rst | 2 -- 2 files changed, 2 insertions(+), 3 deletions(-) diff --git a/event-schemas/schema/m.sticker b/event-schemas/schema/m.sticker index e639823ce7a..1dd1173c9c2 100644 --- a/event-schemas/schema/m.sticker +++ b/event-schemas/schema/m.sticker @@ -18,7 +18,8 @@ properties: Metadata about the image referred to in ``url`` including a thumbnail representation. url: - description: The URL to the sticker image. + description: |- + The URL to the sticker image. This must be a valid ``mxc://`` URI. type: string required: - body diff --git a/specification/modules/stickers.rst b/specification/modules/stickers.rst index b502600ef32..75894b7d828 100644 --- a/specification/modules/stickers.rst +++ b/specification/modules/stickers.rst @@ -42,8 +42,6 @@ Client behaviour Clients supporting this message type should display the image content from the event URL directly in the timeline. -The event ``url`` key must specify a valid ``mxc://`` URI. - A thumbnail image should be provided in the ``info`` object. This is largely intended as a fallback for clients that do not fully support the ``m.sticker`` event type. In most cases it is fine to set the thumbnail URL to the From 114e9e2b0e32016d7fb45c736a4f69d17d862b5a Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Fri, 23 Mar 2018 12:49:25 +0000 Subject: [PATCH 16/19] Fix multiline formatting. --- .../core-event-schema/msgtype_infos/image_info.yaml | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/event-schemas/schema/core-event-schema/msgtype_infos/image_info.yaml b/event-schemas/schema/core-event-schema/msgtype_infos/image_info.yaml index ed4f3fdf9f2..4d2a9964636 100644 --- a/event-schemas/schema/core-event-schema/msgtype_infos/image_info.yaml +++ b/event-schemas/schema/core-event-schema/msgtype_infos/image_info.yaml @@ -2,12 +2,14 @@ $schema: http://json-schema.org/draft-04/schema# description: Metadata about an image. properties: h: - description: The intended display height of the image in pixels. This may - differ from the intrinsic dimensions of the image file. + description: |- + The intended display height of the image in pixels. This may + differ from the intrinsic dimensions of the image file. type: integer w: - description: The intended display width of the image in pixels. This may - differ from the intrinsic dimensions of the image file. + description: |- + The intended display width of the image in pixels. This may + differ from the intrinsic dimensions of the image file. type: integer mimetype: description: The mimetype of the image, e.g. ``image/jpeg``. From 761ad9820ffce34b398cfad0fc1daca51062b66e Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Fri, 23 Mar 2018 12:50:46 +0000 Subject: [PATCH 17/19] Fix errant comma. --- specification/modules/stickers.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/specification/modules/stickers.rst b/specification/modules/stickers.rst index 75894b7d828..346b0d84fe9 100644 --- a/specification/modules/stickers.rst +++ b/specification/modules/stickers.rst @@ -49,5 +49,5 @@ same URL as the main event content. It is recommended that sticker image content should be 512x512 pixels in size or smaller. The dimensions of the image file should be twice the intended -display size specified in the ``info`` object, in order to assist +display size specified in the ``info`` object in order to assist rendering sharp images on higher DPI screens. From 56dc2955d48be59af2d1b2ccac8f2420ad2cde51 Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Fri, 23 Mar 2018 17:23:39 +0000 Subject: [PATCH 18/19] Improve thumbnail dimension descriptions. --- .../core-event-schema/msgtype_infos/thumbnail_info.yaml | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/event-schemas/schema/core-event-schema/msgtype_infos/thumbnail_info.yaml b/event-schemas/schema/core-event-schema/msgtype_infos/thumbnail_info.yaml index 5a233b241a3..82ffaf5e460 100644 --- a/event-schemas/schema/core-event-schema/msgtype_infos/thumbnail_info.yaml +++ b/event-schemas/schema/core-event-schema/msgtype_infos/thumbnail_info.yaml @@ -2,10 +2,14 @@ $schema: http://json-schema.org/draft-04/schema# description: Metadata about a thumbnail image. properties: h: - description: The height of the image in pixels. + description: |- + The intended display height of the image in pixels. This may + differ from the intrinsic dimensions of the image file. type: integer w: - description: The width of the image in pixels. + description: |- + The intended display width of the image in pixels. This may + differ from the intrinsic dimensions of the image file. type: integer mimetype: description: The mimetype of the image, e.g. ``image/jpeg``. From 02c5afbed73d5fd49ed8678abb4d278abfb9f173 Mon Sep 17 00:00:00 2001 From: Richard Lewis Date: Fri, 23 Mar 2018 17:43:05 +0000 Subject: [PATCH 19/19] Update changelog. --- changelogs/client_server.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/changelogs/client_server.rst b/changelogs/client_server.rst index 34fbfdbea37..c29f38c76fd 100644 --- a/changelogs/client_server.rst +++ b/changelogs/client_server.rst @@ -10,8 +10,16 @@ Unreleased changes - ``GET /rooms/{roomId}/event/{eventId}`` (`#1110 `_). + - Sticker messages: + - Add sticker message event definition. + (`#1158 `_). + - Spec clarifications: + - Update ``ImageInfo`` and ``ThumbnailInfo`` dimension schema descriptions + to clarify that they relate to intended display size, as opposed to the + intrinsic size of the image file. + (`#1158 `_). - Mark ``home_server`` return field for ``/login`` and ``/register`` endpoints as deprecated (`#1097 `_).